cash-in) et de transférer (cash-out) sur les réseaux mobile money d’Afrique de l’Ouest et du Centre, directement depuis ses serveurs.
Elle s’adresse aux entreprises qui intègrent le mobile money dans leur propre produit : places de marché, fintechs, opérateurs de paie, plateformes de collecte.
L’API Guichet est distincte de Djonanko Pay. Djonanko Pay sert à encaisser via un lien de paiement ou un QR code, avec une page de paiement hébergée. Le Guichet n’a ni lien ni page : vous appelez l’API, votre client est sollicité sur son téléphone, vous recevez l’issue par notification.Les deux produits ont leurs propres clés, leur propre URL et leur propre documentation. Les clés de l’un ne fonctionnent pas sur l’autre.
Ce que vous pouvez faire
Encaisser
Débiter le compte mobile money d’un client vers votre portefeuille Djonanko.
Transférer
Verser des fonds sur le compte mobile money d’un bénéficiaire.
Suivre votre portefeuille
Solde, part immobilisée, relevé de tous les mouvements.
Être notifié
Notifications signées à chaque issue d’opération.
Les cinq règles à connaître
1
L'URL de base est https://guichet.apidjonanko.tech/v1
Tous les chemins de cette documentation sont relatifs à cette base.
2
Deux en-têtes sur chaque appel
x-api-key et x-api-secret. Voir Authentification.3
Les montants sont des entiers
Le XOF, le XAF et le GNF n’ont pas de sous-unité.
5000 vaut 5 000 FCFA. Aucune décimale n’est acceptée.4
L'en-tête Idempotency-Key est obligatoire sur les opérations
Sans lui, un délai réseau suivi d’un rejeu de votre côté produirait deux opérations. Voir Idempotence.
5
Les notifications ne sont pas la source de vérité
Si une notification vous échappe,
GET /operations/{reference} donne toujours l’état réel. N’attendez jamais une notification indéfiniment.Comment se déroule une opération
Encaissement
Transfert
Pour commencer
Démarrage rapide
De la création du compte au premier encaissement.
Référence API
Tous les endpoints, avec playground interactif.