Liste de contrôle avant la production

Aujourd’hui, chaque compte AdProMaxPay travaille dans le bac à sable. Les paiements réels s’ouvrent avec l’activation, qui arrive : vous nous présentez votre entreprise, nous la vérifions, et votre compte devient actif. Cette page dit comment l’activation fonctionnera et ce qu’il faut préparer, et liste ce qu’il faut vérifier dans votre intégration, pour que le passage en production soit un changement de clés, pas de code.

C’est possible parce que le mode test et la production exécutent le même code : voir Bac à sable et production : les différences.

Comment fonctionne l’activationCopier le lien de la section

L’activation_status de votre compte, dans GET /v1/account, dit où il en est. Il vaut sandbox tant que vous ne demandez pas l’activation.

1. Vous soumettez les informations et les documents de votre entreprise dans le tableau de bord.
2. Notre équipe les examine. S’il manque quelque chose ou si un point n’est pas clair, nous demandons des informations, avec une échéance, et affichons la raison à côté de chaque champ concerné. Votre réponse renvoie le dossier à l’examen.
3. Notre partenaire de paiement agréé, qui détient les fonds, approuve ensuite votre entreprise à son tour. Le tableau de bord indique le temps que cela prend d’habitude.
4. Votre compte est active : les clés de production fonctionnent, et les paiements de production sont réels.

Les paiements par carte et les paiements en espèces s’activent séparément. GET /v1/account montre chacun dans capabilities.card_payments et capabilities.cash_payments : inactive, pending ou active.

Si l’activation est refusée, vous en recevez la raison, et votre organisation reste dans le bac à sable : vos clés de test et vos données de test continuent de fonctionner. Plus tard, un compte actif peut passer restricted, avec les paiements ou les versements suspendus, le temps d’examiner une retenue.

Ce qu’il faut préparerCopier le lien de la section

La liste ci-dessous est en cours de confirmation et peut changer. La réunir tôt fait gagner du temps.

• Votre entreprise : forme juridique, raison sociale, numéro et ville du registre du commerce (RC), ICE (15 chiffres), identifiant fiscal (IF), inscription à la taxe professionnelle, adresse, activité, et votre site web ou votre profil sur les réseaux sociaux. Auto-entrepreneur : votre carte d’auto-entrepreneur à la place du RC.
• Ses personnes : le représentant légal et les bénéficiaires effectifs, avec leur nom, leur pièce d’identité et leur part.
• Son compte bancaire : le RIB (24 chiffres) et l’attestation de la banque.
• Des documents : statuts, pièces d’identité, justificatif d’adresse.
• Des informations publiques : le nom sur les relevés de vos clients, un e-mail et un téléphone de support, votre logo.
• La connexion de votre équipe : un e-mail vérifié, et la vérification en deux étapes pour chaque personne qui travaillera en production (voir Sécurité).

Vérifier votre intégrationCopier le lien de la section

Parcourez cette liste avant de basculer. Chaque ligne renvoie à la page qui l’explique.

1. Un endpoint de webhook de production. Les endpoints appartiennent à un seul mode : créez-en un pour la production, conservez son propre secret, vérifiez la signature de chaque livraison, gérez une livraison qui arrive deux fois, et répondez 2xx rapidement (Nouvelles tentatives, ordre et déduplication).
2. Livrer sur le bon signal : payment_intent.succeeded, ou le statut de l’intention de paiement lu avec votre clé secrète ; jamais le retour sur votre success_url (Le fonctionnement des paiements).
3. Idempotence : une Idempotency-Key sur chaque requête qui déplace de l’argent, gardée d’une tentative à l’autre (Idempotence).
4. Erreurs : votre code se décide sur code, jamais sur message, et journalise request_id (Gérer les erreurs).
5. Clés : les clés secrètes sur votre serveur seulement, lues dans son environnement ou un gestionnaire de secrets (Sécurité).
6. Limites : votre code gère 429 et Retry-After ; demandez une limite plus haute avant une campagne (Limites de débit).
7. Espèces : vous affichez l’amount_to_pay et l’échéance du bon tels qu’ils sont donnés, gérez les codes expirés, et respectez le minimum de 100,00 MAD (Paiements en espèces).
8. Remboursements : seuls les paiements par carte sont remboursés, et en production un remboursement peut prendre plus de temps ; vos clients connaissent votre politique pour les paiements en espèces avant de payer (Remboursements).
9. Image de marque : votre logo, votre nom affiché et votre contact de support sur les pages de paiement, sous Paramètres → Image de marque.
10. Équipe : chaque personne a le rôle dont elle a besoin, et tout le monde utilise la vérification en deux étapes (Équipe et rôles).
11. Chaque scénario de Tester votre intégration passe.

Passer en productionCopier le lien de la section

Une fois votre compte actif :

1. Passez le tableau de bord en production, et créez vos clés de production sous Développeurs → Clés d’API. Une clé secrète de production (apx_sk_live_…) s’affiche une seule fois, à sa création : conservez-la à ce moment-là.
2. Placez les clés de production dans votre configuration de production seulement. Vos machines de développement et de test gardent leurs clés de test.
3. Créez votre endpoint de webhook de production, et conservez son secret.
4. Recréez vos clients et vos liens de paiement en production : les objets de test restent en mode test.
5. Relisez Bac à sable et production : les différences : en production, la page carte est la page sécurisée de notre partenaire carte, le 3-D Secure vient de la banque de votre client, les codes espèces sont vérifiés toutes les 2 minutes, les fonds deviennent disponibles après la durée de rétention fixée à l’activation, et les remboursements peuvent rester pending plus longtemps.
6. Faites un premier petit paiement réel, et suivez-le jusqu’à son webhook.

Ce qui arriveCopier le lien de la section

L’activation apportera, sans date pour l’instant :

• l’activation dans le tableau de bord : vos informations, vos documents et l’avancement de l’examen ;
• les clés de production et le mode production ;
• la vérification en deux étapes exigée pour la production, et redemandée pour les actions sensibles, comme créer une clé de production ou modifier votre équipe ;
• les versements sur votre compte bancaire, avec leurs rapports ;
• la durée de rétention de votre solde de production ;
• les frais et les factures.

Nous annoncerons chacun dans le journal des modifications.