Vous avez un site ou une application et vous voulez encaisser par Mobile Money sans rediriger vos clients vers un autre service ? Une API de paiement vous donne le contrôle : vous créez le paiement côté serveur, vous envoyez votre client sur une page de paiement à votre marque, et vous êtes prévenu dès que c'est payé.
1. Clés de test et de production
Deux clés distinctes : une de test (sk_test_…) pour développer et tester sans argent réel, et une de production (sk_live_…) pour le vrai lancement. Ne mettez jamais la clé de production dans le code côté navigateur.
2. Créer un paiement
Depuis votre serveur, vous appelez l'API avec le montant, une référence et une adresse de retour. L'API vous renvoie une adresse de paiement (checkout_url). Vous y redirigez votre client.
3. La page de paiement
Votre client choisit son réseau (Orange, Moov, MTN, Wave, Free), saisit son numéro et confirme sur son téléphone. Vous n'avez rien à développer : la page est fournie, aux couleurs de votre entreprise.
4. Les webhooks : être prévenu
Au lieu de demander sans cesse « c'est payé ? », vous recevez une notification signée sur votre serveur dès que le statut change. Chaque notification est signée : vous vérifiez qu'elle vient bien du service. Les relances automatiques gèrent les échecs temporaires.
5. La protection contre les doublons
Envoyez une clé d'idempotence (Idempotency-Key) avec chaque création : si le réseau coupe au mauvais moment, renvoyer la même requête ne crée pas un deuxième paiement. C'est essentiel pour ne jamais faire payer un client deux fois.
6. Le mode test de bout en bout
En mode test, un numéro finissant par 00 échoue (« solde insuffisant »), un numéro finissant par 99 reste en attente (avec des boutons pour simuler un succès ou un échec), et un code OTP précis réussit. Vérifiez vos webhooks et vos e-mails avant de passer en live.
Une bonne API de paiement, c'est celle dont on oublie qu'elle existe : elle fait son travail et vous prévient.