# Djonanko Pay

> Documentation développeur de Djonanko Pay — la passerelle de paiement mobile money pour l'Afrique de l'Ouest et du Centre.

- [Bienvenue sur Djonanko Pay](https://docs.djonanko.ci/introduction.md): Encaissez des paiements mobile money et carte en Côte d'Ivoire, au Burkina Faso, au Mali et au Cameroun avec une seule API.
- [Démarrage rapide](https://docs.djonanko.ci/demarrage-rapide.md): De la création du compte au premier paiement encaissé, en 5 étapes.
- [Authentification](https://docs.djonanko.ci/concepts/authentification.md): Clé API pour l'intégration serveur, jeton marchand pour les opérations du dashboard.
- [Flux de paiement](https://docs.djonanko.ci/concepts/flux-de-paiement.md): Le cycle de vie d'un paiement, de la création du lien à la notification, et les statuts possibles.
- [Pays et opérateurs](https://docs.djonanko.ci/concepts/pays-et-operateurs.md): Les pays couverts, les opérateurs disponibles et les valeurs renvoyées par l'API.
- [Gestion des erreurs](https://docs.djonanko.ci/concepts/erreurs.md): Format des erreurs, codes HTTP et messages que vous pouvez rencontrer.
- [Créer un lien de paiement](https://docs.djonanko.ci/guides/lien-de-paiement.md): Intégrer le paiement par redirection dans un site e-commerce ou une application.
- [Paiement par QR code](https://docs.djonanko.ci/guides/qr-code.md): Générer un QR code à afficher en boutique, sur une facture ou sur un écran.
- [Vérifier un paiement](https://docs.djonanko.ci/guides/verifier-un-paiement.md): Interroger le statut d'un paiement et rapprocher vos commandes.
- [Webhooks](https://docs.djonanko.ci/guides/webhooks.md): Recevoir les notifications de paiement, les traiter de façon fiable et surveiller les échecs.
- [Reversements](https://docs.djonanko.ci/guides/reversements.md): Récupérer vos fonds sur un compte mobile money ou bancaire.
- [Whitelisting IP](https://docs.djonanko.ci/guides/ip-whitelisting.md): Déclarer les adresses IP de vos serveurs — obligatoire à partir du 25 septembre 2026.
- [Rotation des clés API](https://docs.djonanko.ci/guides/rotation-des-cles.md): Régénérer votre secret API en cas de perte ou de compromission, sans interruption de service.
- [Collection Postman](https://docs.djonanko.ci/guides/postman.md): Tester l'API depuis Postman avec la collection officielle.
- [Mise en production](https://docs.djonanko.ci/guides/mise-en-production.md): La checklist à valider avant d'ouvrir les paiements à vos clients.
- [Tableau de bord](https://docs.djonanko.ci/dashboard/apercu.md): Vue d'ensemble de votre activité : compteurs, volume du mois et dernières collectes.
- [Transactions](https://docs.djonanko.ci/dashboard/transactions.md): Rechercher, filtrer et exporter vos collectes en PDF, Excel ou CSV.
- [Remboursements](https://docs.djonanko.ci/dashboard/remboursements.md): Demander un reversement de votre solde et suivre son traitement.
- [Gestion des comptes](https://docs.djonanko.ci/dashboard/gestion-des-comptes.md): Enregistrer vos comptes mobile money et bancaires de reversement.
- [Rapports mensuels](https://docs.djonanko.ci/dashboard/rapports.md): Un récapitulatif PDF de votre activité, généré automatiquement chaque mois.
- [Espace Développeur](https://docs.djonanko.ci/dashboard/developpeur.md): Vos identifiants d'intégration, l'URL de webhook et les adresses IP autorisées.
- [Référence API](https://docs.djonanko.ci/api-reference/introduction.md): URL de base, authentification, conventions et liste des endpoints.
- [Utiliser le playground](https://docs.djonanko.ci/api-reference/playground.md): Tester chaque endpoint en direct depuis cette documentation, avec vos propres identifiants.
- [Obtenir un jeton marchand](https://docs.djonanko.ci/api-reference/auth/login-merchant.md): Authentifie un marchand avec les identifiants reçus par SMS à la création du compte (numéro de téléphone + mot de passe) et renvoie un JWT à passer dans l'en-tête `authenticationtoken` des endpoints du dashboard.
- [Régénérer le secret API](https://docs.djonanko.ci/api-reference/auth/regenerate-api-key.md): Génère un nouveau `x-api-secret`. **L'ancien secret est invalidé immédiatement** ; la clé `x-api-key` reste inchangée. Le nouveau secret est aussi envoyé par SMS au numéro du compte.
- [Créer un lien de paiement](https://docs.djonanko.ci/api-reference/paiements/create-web-payment-link.md): Crée une intention de paiement et renvoie soit une **URL de page de paiement hébergée**, soit un **QR code** (`isQrCode: true`). Le lien expire au bout de **24 heures**.
- [Vérifier le statut d'un paiement](https://docs.djonanko.ci/api-reference/paiements/payment-status.md): Renvoie le statut courant d'un paiement à partir de sa référence `PAY…`. Utilisez cet endpoint pour **confirmer côté serveur** un webhook reçu, ou pour interroger un paiement dont vous n'avez pas reçu de notification.
- [Lister les paiements](https://docs.djonanko.ci/api-reference/paiements/list-payments.md): Renvoie tous les paiements du marchand, du plus récent au plus ancien.
- [Rechercher des paiements](https://docs.djonanko.ci/api-reference/paiements/search-payments.md): Recherche filtrée, identique à celle de l'onglet **Transactions** du dashboard.
- [Exporter les paiements](https://docs.djonanko.ci/api-reference/paiements/export-payments.md): Exporte les paiements filtrés au format **PDF**, **Excel** ou **CSV**. La réponse est un fichier binaire (`Content-Disposition: attachment`).
- [Consulter le solde](https://docs.djonanko.ci/api-reference/solde/get-balance.md): Solde disponible pour reversement, en FCFA. Le solde est crédité à chaque paiement `SUCCESS`, net de frais.
- [Compteurs de transactions](https://docs.djonanko.ci/api-reference/solde/transactions-count.md): Nombre de paiements par statut depuis la création du compte.
- [Compteurs du mois en cours](https://docs.djonanko.ci/api-reference/solde/monthly-transactions-count.md)
- [Volume du mois en cours](https://docs.djonanko.ci/api-reference/solde/transactions-flow.md): Volume encaissé, nombre de transactions et taux de conversion du mois en cours.
- [Notification de paiement](https://docs.djonanko.ci/api-reference/webhooks/payment-notification.md): Envoyée en `POST` sur votre URL de webhook dès qu'un paiement aboutit (`SUCCESS`) ou échoue (`FAILED`).
- [Définir l'URL de webhook](https://docs.djonanko.ci/api-reference/webhooks/set-webhook-url.md): Enregistre l'URL HTTPS sur laquelle Djonanko enverra les notifications de paiement. L'URL **ne doit pas être protégée par une authentification** et doit répondre `2xx` rapidement.
- [Lister les webhooks en échec](https://docs.djonanko.ci/api-reference/webhooks/list-failed.md): Liste les livraisons de webhook en échec du marchand authentifié, les plus récentes d'abord. Par défaut, renvoie les statuts `FAILED` et `ABANDONED`.
- [Rejouer un webhook](https://docs.djonanko.ci/api-reference/webhooks/replay.md): Rejoue **immédiatement** une livraison en échec et renvoie le résultat de la tentative. Le compteur de tentatives est remis à zéro. L'appel est bloquant le temps de la tentative (timeout 15 s).
- [Demander un reversement](https://docs.djonanko.ci/api-reference/reversements/request-disbursement.md): Crée une demande de reversement de votre solde vers votre **compte principal de reversement**. Montant minimum : **500 FCFA**. La demande passe en `PENDING` jusqu'à validation par Djonanko.
- [Lister les reversements](https://docs.djonanko.ci/api-reference/reversements/list-disbursements.md)
- [Compteurs de reversements](https://docs.djonanko.ci/api-reference/reversements/refunds-stats.md)
- [Lister les comptes de reversement](https://docs.djonanko.ci/api-reference/reversements/list-payout-accounts.md)
- [Ajouter un compte de reversement](https://docs.djonanko.ci/api-reference/reversements/create-payout-account.md): Ajoute un compte **mobile money** (`orange`, `moov`, `mtn`, `wave`) ou **bancaire** (`bank`). Les champs requis dépendent du `type`.
- [Définir le compte principal](https://docs.djonanko.ci/api-reference/reversements/set-primary-payout-account.md)
- [Supprimer un compte de reversement](https://docs.djonanko.ci/api-reference/reversements/delete-payout-account.md)
- [Lister les banques disponibles](https://docs.djonanko.ci/api-reference/reversements/list-banks.md): Banques acceptées pour les comptes de reversement bancaires. Utilisez `id` dans `bankId`.
- [Lister les IPs autorisées](https://docs.djonanko.ci/api-reference/securite/list-allowed-ips.md): Renvoie les adresses IP enregistrées ainsi que la date d'entrée en vigueur du whitelisting.
- [Ajouter une IP autorisée](https://docs.djonanko.ci/api-reference/securite/create-allowed-ip.md): Accepte une IPv4, une IPv6 ou une plage CIDR (ex. `41.207.12.0/24`). Maximum 20 entrées par marchand.
- [Retirer une IP autorisée](https://docs.djonanko.ci/api-reference/securite/delete-allowed-ip.md)
- [Lister les rapports mensuels](https://docs.djonanko.ci/api-reference/rapports/list-reports.md): Rapports PDF générés automatiquement chaque début de mois pour le mois écoulé.
- [Générer un rapport](https://docs.djonanko.ci/api-reference/rapports/generate-report.md): Génère (ou regénère) le rapport d'un mois **écoulé**. Le mois en cours n'est pas disponible.
- [Télécharger un rapport](https://docs.djonanko.ci/api-reference/rapports/download-report.md): Redirige (`302`) vers l'URL du fichier PDF.
- [Créer un compte marchand](https://docs.djonanko.ci/api-reference/compte/register.md): Crée un compte marchand. Les identifiants (clé API, secret API, référence, identifiant et mot de passe du dashboard) sont envoyés **par SMS** au numéro fourni. Le compte doit ensuite être **activé par Djonanko** avant de pouvoir encaisser.
- [Consulter le profil marchand](https://docs.djonanko.ci/api-reference/compte/get-merchant.md): Renvoie le profil du compte (référence, URLs, clé API publique, solde, statut d'activation).
- [Obtenir un jeton marchand](https://docs.djonanko.ci/api-reference/authentification/obtenir-un-jeton-marchand.md): Authentifie un marchand avec les identifiants reçus par SMS à la création du compte (numéro de téléphone + mot de passe) et renvoie un JWT à passer dans l'en-tête `authenticationtoken` des endpoints du dashboard.
- [Régénérer le secret API](https://docs.djonanko.ci/api-reference/authentification/régénérer-le-secret-api.md): Génère un nouveau `x-api-secret`. **L'ancien secret est invalidé immédiatement** ; la clé `x-api-key` reste inchangée. Le nouveau secret est aussi envoyé par SMS au numéro du compte.
- [Créer un lien de paiement](https://docs.djonanko.ci/api-reference/paiements/créer-un-lien-de-paiement.md): Crée une intention de paiement et renvoie soit une **URL de page de paiement hébergée**, soit un **QR code** (`isQrCode: true`). Le lien expire au bout de **24 heures**.
- [Vérifier le statut d'un paiement](https://docs.djonanko.ci/api-reference/paiements/vérifier-le-statut-dun-paiement.md): Renvoie le statut courant d'un paiement à partir de sa référence `PAY…`. Utilisez cet endpoint pour **confirmer côté serveur** un webhook reçu, ou pour interroger un paiement dont vous n'avez pas reçu de notification.
- [Lister les paiements](https://docs.djonanko.ci/api-reference/paiements/lister-les-paiements.md): Renvoie tous les paiements du marchand, du plus récent au plus ancien.
- [Rechercher des paiements](https://docs.djonanko.ci/api-reference/paiements/rechercher-des-paiements.md): Recherche filtrée, identique à celle de l'onglet **Transactions** du dashboard.
- [Exporter les paiements](https://docs.djonanko.ci/api-reference/paiements/exporter-les-paiements.md): Exporte les paiements filtrés au format **PDF**, **Excel** ou **CSV**. La réponse est un fichier binaire (`Content-Disposition: attachment`).
- [Consulter le solde](https://docs.djonanko.ci/api-reference/solde-&-statistiques/consulter-le-solde.md): Solde disponible pour reversement, en FCFA. Le solde est crédité à chaque paiement `SUCCESS`, net de frais.
- [Compteurs de transactions](https://docs.djonanko.ci/api-reference/solde-&-statistiques/compteurs-de-transactions.md): Nombre de paiements par statut depuis la création du compte.
- [Compteurs du mois en cours](https://docs.djonanko.ci/api-reference/solde-&-statistiques/compteurs-du-mois-en-cours.md)
- [Volume du mois en cours](https://docs.djonanko.ci/api-reference/solde-&-statistiques/volume-du-mois-en-cours.md): Volume encaissé, nombre de transactions et taux de conversion du mois en cours.
- [Définir l'URL de webhook](https://docs.djonanko.ci/api-reference/webhooks/définir-lurl-de-webhook.md): Enregistre l'URL HTTPS sur laquelle Djonanko enverra les notifications de paiement. L'URL **ne doit pas être protégée par une authentification** et doit répondre `2xx` rapidement.
- [Lister les webhooks en échec](https://docs.djonanko.ci/api-reference/webhooks/lister-les-webhooks-en-échec.md): Liste les livraisons de webhook en échec du marchand authentifié, les plus récentes d'abord. Par défaut, renvoie les statuts `FAILED` et `ABANDONED`.
- [Rejouer un webhook](https://docs.djonanko.ci/api-reference/webhooks/rejouer-un-webhook.md): Rejoue **immédiatement** une livraison en échec et renvoie le résultat de la tentative. Le compteur de tentatives est remis à zéro. L'appel est bloquant le temps de la tentative (timeout 15 s).
- [Notification de paiement](https://docs.djonanko.ci/api-reference/webhooks/notification-de-paiement.md): Envoyée en `POST` sur votre URL de webhook dès qu'un paiement aboutit (`SUCCESS`) ou échoue (`FAILED`).
- [Demander un reversement](https://docs.djonanko.ci/api-reference/reversements/demander-un-reversement.md): Crée une demande de reversement de votre solde vers votre **compte principal de reversement**. Montant minimum : **500 FCFA**. La demande passe en `PENDING` jusqu'à validation par Djonanko.
- [Lister les reversements](https://docs.djonanko.ci/api-reference/reversements/lister-les-reversements.md)
- [Compteurs de reversements](https://docs.djonanko.ci/api-reference/reversements/compteurs-de-reversements.md)
- [Lister les comptes de reversement](https://docs.djonanko.ci/api-reference/reversements/lister-les-comptes-de-reversement.md)
- [Ajouter un compte de reversement](https://docs.djonanko.ci/api-reference/reversements/ajouter-un-compte-de-reversement.md): Ajoute un compte **mobile money** (`orange`, `moov`, `mtn`, `wave`) ou **bancaire** (`bank`). Les champs requis dépendent du `type`.
- [Définir le compte principal](https://docs.djonanko.ci/api-reference/reversements/définir-le-compte-principal.md)
- [Supprimer un compte de reversement](https://docs.djonanko.ci/api-reference/reversements/supprimer-un-compte-de-reversement.md)
- [Lister les banques disponibles](https://docs.djonanko.ci/api-reference/reversements/lister-les-banques-disponibles.md): Banques acceptées pour les comptes de reversement bancaires. Utilisez `id` dans `bankId`.
- [Lister les IPs autorisées](https://docs.djonanko.ci/api-reference/sécurité/lister-les-ips-autorisées.md): Renvoie les adresses IP enregistrées ainsi que la date d'entrée en vigueur du whitelisting.
- [Ajouter une IP autorisée](https://docs.djonanko.ci/api-reference/sécurité/ajouter-une-ip-autorisée.md): Accepte une IPv4, une IPv6 ou une plage CIDR (ex. `41.207.12.0/24`). Maximum 20 entrées par marchand.
- [Retirer une IP autorisée](https://docs.djonanko.ci/api-reference/sécurité/retirer-une-ip-autorisée.md)
- [Lister les rapports mensuels](https://docs.djonanko.ci/api-reference/rapports/lister-les-rapports-mensuels.md): Rapports PDF générés automatiquement chaque début de mois pour le mois écoulé.
- [Générer un rapport](https://docs.djonanko.ci/api-reference/rapports/générer-un-rapport.md): Génère (ou regénère) le rapport d'un mois **écoulé**. Le mois en cours n'est pas disponible.
- [Télécharger un rapport](https://docs.djonanko.ci/api-reference/rapports/télécharger-un-rapport.md): Redirige (`302`) vers l'URL du fichier PDF.
- [Créer un compte marchand](https://docs.djonanko.ci/api-reference/compte-marchand/créer-un-compte-marchand.md): Crée un compte marchand. Les identifiants (clé API, secret API, référence, identifiant et mot de passe du dashboard) sont envoyés **par SMS** au numéro fourni. Le compte doit ensuite être **activé par Djonanko** avant de pouvoir encaisser.
- [Consulter le profil marchand](https://docs.djonanko.ci/api-reference/compte-marchand/consulter-le-profil-marchand.md): Renvoie le profil du compte (référence, URLs, clé API publique, solde, statut d'activation).

## OpenAPI Specs

- [openapi](/openapi.yaml)