Mise en production

Les règles à respecter, la conduite à tenir après une erreur et la checklist à valider avant d'accepter des paiements réels.

Règles d'intégration importantes

Utiliser une référence métier unique pour chaque paiement.
Ne jamais considérer PENDING comme un paiement réussi.
Conserver le transaction_id retourné par DarePay.
Traiter le callback comme la notification principale du résultat final.
Rendre le traitement du callback idempotent : recevoir deux fois la même notification ne doit pas provoquer deux fois la même opération métier.
Après une erreur réseau ou HTTP 500 lors de l'initiation, vérifier d'abord le statut du paiement avant de créer une nouvelle transaction.
Ne jamais exposer votre X-API-Key dans une application frontend publique.
Utiliser HTTPS en production.

Reprise après erreur

Une erreur réseau ou une réponse 500 ne veut pas dire que le paiement a échoué : la transaction a pu être créée. Ne concluez jamais automatiquement à un échec.

L'initiation échoue : coupure réseau ou HTTP 500

Ne créez pas de nouvelle transaction tout de suite.

Consultez le statut avec la même référence

GET /api/payments/{reference}/status, puis agissez selon la réponse :

200 PENDINGLe paiement existe et suit son cours. Attendez le callback.

200 SUCCESS / FAILEDLe paiement a atteint son état final. Appliquez ce résultat. Pour réessayer un paiement échoué, créez-en un nouveau avec une nouvelle référence : l'ancienne renverrait une erreur 409.

404 IntrouvableLe paiement n'a pas été créé. Vous pouvez retenter l'initiation.

HTTP	Situation	Action recommandée
401	Clé API absente ou invalide	Vérifier l'en-tête `X-API-Key`.
409	Un paiement existe déjà avec cette référence	Ne pas initier un nouveau paiement avec la même référence.
422	Erreur de validation métier	Corriger les données ou vérifier l'état de la transaction.
500	Erreur interne	Vérifier le statut avant de retenter.

Tous les codes d'erreur

Checklist avant mise en production

Cochez chaque point une fois vérifié. Votre progression est enregistrée dans ce navigateur.

Prêt pour la production 0/7

Votre clé API DarePay est enregistrée uniquement côté serveur.
Votre application génère une référence unique par paiement.10 caractères maximum.
Votre endpoint callback est accessible en HTTPS.
Votre endpoint callback accepte les requêtes POST JSON.Et répond HTTP 200 avec received, reference et transaction_id.
Votre application sait gérer PENDING, SUCCESS et FAILED.
Votre traitement de callback est idempotent.
Votre application sait consulter /api/payments/{reference}/status en cas de doute.

Tous les points sont validés : votre intégration est prête.