Skip to main content
Le lien de paiement est le mode d’intégration le plus simple : vous créez le lien côté serveur, redirigez le client, et attendez le webhook.

Paramètres

Renseignez toujours metadata.order_id. Il vous revient dans le webhook et devient la « référence marchand » du paiement dans le dashboard, les exports et les rapports.

Exemple complet — Express.js

Exemple — Laravel

Exemple — Django

Idempotence

L’API ne déduplique pas les liens : deux appels créent deux liens. Pour éviter de facturer deux fois un client qui rafraîchit la page :
  1. stockez la reference sur la commande dès le premier appel ;
  2. si une référence existe déjà et que le paiement est encore PENDING (vérifiez avec GET /payment/status), redirigez vers https://checkout.djonanko.ci/{reference} sans recréer de lien.

Que se passe-t-il au retour ?

  • return_url : le client a validé le paiement. Affichez une page d’attente tant que votre webhook n’a pas confirmé SUCCESS — la redirection seule n’est pas une preuve.
  • cancel_url : le client a annulé ou l’opérateur a refusé. Proposez de réessayer avec un nouveau lien.

Étape suivante : recevoir les webhooks

Configurez l’URL de notification et traitez les événements SUCCESS / FAILED.