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
PENDINGcomme un paiement réussi. - Conserver le
transaction_idretourné 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-Keydans une application frontend publique. - Utiliser HTTPS en production.
Application e-commerce ?Si votre application envoie de l'argent aux vendeurs, livreurs ou clients, validez aussi la checklist e-commerce et les conditions d'envoi.
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.
Ne créez pas de nouvelle transaction tout de suite.
GET /api/payments/{reference}/status, puis agissez selon la réponse :
| 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. |
Checklist avant mise en production
Cochez chaque point une fois vérifié. Votre progression est enregistrée dans ce navigateur.