# Liste de contrôle avant la production

Comment l’activation ouvrira les paiements réels, ce qu’il faut préparer, et ce qu’il faut vérifier avant de passer des clés de test aux clés de 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](https://pay-docs.adpromax.com/fr/sandbox/differences).

## Comment fonctionne l’activation

L’`activation_status` de votre compte, dans [`GET /v1/account`](https://pay-docs.adpromax.com/fr/get-started/api-keys), dit où il en
est. Il vaut `sandbox` tant que vous ne demandez pas l’activation.

L’activation d’un compte:

- `sandbox` → `submitted`: vous soumettez
- `submitted` → `under_review`
- `under_review` → `information_requested`
- `information_requested` → `under_review`
- `under_review` → `partner_review`: approuvé par nous
- `partner_review` → `active`: approuvé par notre partenaire
- `under_review` → `rejected`: refusé
- `partner_review` → `rejected`

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éparer

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é](https://pay-docs.adpromax.com/fr/account/security)).

## Vérifier votre intégration

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](https://pay-docs.adpromax.com/fr/webhooks/signatures) de
   chaque livraison, gérez une livraison qui arrive deux fois, et répondez `2xx` rapidement
   ([Nouvelles tentatives, ordre et déduplication](https://pay-docs.adpromax.com/fr/webhooks/retries)).
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](https://pay-docs.adpromax.com/fr/payments/how-payments-work#redirections-et-webhooks--auquel-se-fier)).
3. **Idempotence** : une `Idempotency-Key` sur chaque requête qui déplace de l’argent, gardée d’une
   tentative à l’autre ([Idempotence](https://pay-docs.adpromax.com/fr/api-reference/idempotency)).
4. **Erreurs** : votre code se décide sur `code`, jamais sur `message`, et journalise `request_id`
   ([Gérer les erreurs](https://pay-docs.adpromax.com/fr/errors)).
5. **Clés** : les clés secrètes sur votre serveur seulement, lues dans son environnement ou un
   gestionnaire de secrets ([Sécurité](https://pay-docs.adpromax.com/fr/account/security)).
6. **Limites** : votre code gère `429` et `Retry-After` ; demandez une limite plus haute avant une
   campagne ([Limites de débit](https://pay-docs.adpromax.com/fr/api-reference/rate-limits)).
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](https://pay-docs.adpromax.com/fr/payments/cash-payments)).
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](https://pay-docs.adpromax.com/fr/payments/refunds)).
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](https://pay-docs.adpromax.com/fr/account/team-and-roles)).
11. **Chaque scénario** de [Tester votre intégration](https://pay-docs.adpromax.com/fr/get-started/test-your-integration) passe.

## Passer en production

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](https://pay-docs.adpromax.com/fr/sandbox/differences) : 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 arrive

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](https://pay-docs.adpromax.com/fr/changelog).