API de mobile money avec un vrai bac à sable

Demande de paiement, page de paiement, liens, reversements, factures et remboursements. Chaque appel accepte une clé d'idempotence : une nouvelle tentative ne paie jamais deux fois. Les webhooks sont signés, avec une fenêtre de temps, et les répétitions sont sans effet.

Des bibliothèques en un seul fichier pour Node.js, Python et PHP gèrent le renouvellement des jetons, les nouvelles tentatives et le contrôle des webhooks. Sans dépendance, elles n'ont rien à auditer ni à corriger, et se copient sur un hébergement mutualisé.

Le portail développeur montre le trafic par jour, les principaux points d'accès, la santé des webhooks et votre chemin vers la production. Des plugins couvrent les boutiques courantes et la documentation donne un exemple par tâche.

L'encaissement : votre système demande au client d'approuver un paiement, en général par une invite sur son téléphone, puis attend le résultat. Le décaissement : votre système paie un numéro ou un compte bancaire depuis votre solde. Les deux se terminent après la requête : ne prenez jamais la première réponse pour le résultat final. La vérité, c'est le webhook signé ou une requête de statut.

Les nouvelles tentatives doivent être sûres : envoyez deux fois la même clé d'idempotence et l'argent ne bouge qu'une fois. Les webhooks doivent être signés, pour que personne ne simule un succès et n'emporte vos marchandises. Un bac à sable doit produire des échecs à la demande, comme un délai dépassé ou un paiement refusé, car ce sont ces cas qui font perdre de l'argent en production. Les erreurs doivent dire quoi faire ensuite, pas seulement qu'il y a eu un problème.

Provoquez les échecs dans le bac à sable : client qui refuse, délai dépassé, requête en double et webhook tardif. Vérifiez que vos propres comptes restent justes dans chaque cas. Passez ensuite en production avec un petit montant et un seul type de paiement, et rapprochez à la main une fois avant de faire confiance. Notre documentation couvre la mise en production, avec des bibliothèques qui n'ajoutent aucune dépendance à votre projet.