Skip to main content
Djonanko Pay n’a pas d’environnement sandbox séparé : les tests se font en production avec de petits montants (minimum 101 FCFA) que vous pouvez ensuite reverser. Les paiements de test apparaissent dans votre dashboard comme n’importe quel autre.

​
Checklist

Compte

  • Le compte marchand est activé par Djonanko (la création de lien ne renvoie plus 403).
  • La référence marchand utilisée dans le code correspond à celle du dashboard (sensible à la casse).
  • Un compte de reversement est enregistré et défini comme principal.

Sécurité

  • Le secret API est stocké dans un gestionnaire de secrets, absent du code et des dépôts.
  • Le secret n’est utilisé que côté serveur, jamais dans une app mobile ou du JavaScript navigateur.
  • Les IPs sortantes de production et de préproduction sont déclarées (obligatoire à partir du 25/09/2026).
  • L’URL de webhook utilise un chemin non devinable.

Paiements

  • Chaque commande stocke la reference du lien avant la redirection.
  • metadata.order_id est renseigné à chaque création.
  • Un rafraîchissement de page ne crée pas un second lien pour la même commande.
  • Les pages return_url et cancel_url existent et gèrent le cas « paiement en attente de confirmation ».
  • Un paiement de test de bout en bout a été réalisé pour chaque opérateur que vous comptez proposer.

Webhooks

  • L’URL est en HTTPS, publique, sans authentification, et répond 200 en moins de 15 s.
  • Le traitement est idempotent : un webhook rejoué ne livre pas deux fois.
  • Le statut est confirmé via GET /payment/status avant toute action irréversible.
  • Cloudflare / WAF laisse passer User-Agent: Djonanko-Webhook/1.0 sur le chemin du webhook.
  • Un job de rattrapage interroge le statut des commandes PENDING de plus de quelques minutes.
  • Une alerte est en place si l’onglet Webhooks en échec se remplit.

Exploitation

  • Les erreurs API sont journalisées avec le corps complet de la réponse.
  • Les appels en 500 ou timeout sont réessayés avec backoff, sans dupliquer les liens.
  • L’équipe finance sait où trouver les exports et les rapports mensuels.
  • Une procédure de rotation du secret est documentée en interne.

​
Limites à connaître

​
Support

Pour l’activation du compte, une question d’intégration ou un incident : contactez l’équipe Djonanko en précisant votre référence marchand et, le cas échéant, la référence PAY… du paiement concerné.