Pour commencer
Mode Test et mode Production
Développez sur les données Test avec le simulateur Abuna ou les bacs à sable des prestataires, puis passez en production avec le même code.
Le mode Test vous permet de construire et d'essayer toute votre facturation sans qu'aucun argent ne circule, puis de passer en production avec le même code. Chaque application possède deux modes, Test et Production. Chacun a son propre ID d'application, ses clés secrètes, sa clé publiable, son secret de signature de webhook, son URL du webhook et ses données. L'ID d'application dans le chemin détermine le mode. Il n'existe aucun paramètre de mode.
Dans le tableau de bord, utilisez le sélecteur Test / Production pour passer de l'un à l'autre. Dans l'API, GET /v1/apps/{appID} renvoie l'environment de l'application, test ou live. Chaque contenu de webhook le porte aussi.
Mode Test
Développez et testez avec l'ID d'application Test et sa clé sk_test_. Le mode Test fonctionne comme le mode Production, à ces différences près :
- Les paiements ne déplacent aucun argent. Ils passent par le simulateur Abuna, ou par le bac à sable d'un prestataire que vous connectez. Voyez Paiements de test.
- Vous n'avez pas besoin d'un e-mail vérifié.
- Les limites de forfait sur les abonnés ne s'appliquent pas, et votre forfait ne rend jamais une application Test en lecture seule.
- Les e-mails et messages WhatsApp et Telegram destinés aux clients ne sont pas envoyés, sauf trois codes par e-mail qui partent comme en production : le code qui démarre un essai gratuit, le code qui confirme une nouvelle adresse e-mail dans l'espace client, et le code des informations enregistrées d'un client. Abuna enregistre chaque message comme un événement
notification.captured, qui n'atteint jamais l'URL de votre webhook. L'événement d'un code le donne dans son sujet, pour que vous puissiez finir avec une adresse inventée. La liste des notifications ne contient que les codes d'essai gratuit et de changement d'e-mail. Voyez Messages aux clients en mode Test. Le code qui confirme le numéro WhatsApp d'un client n'est pas envoyé : la page l'affiche, pour que vous puissiez activer WhatsApp. - Les
success_urletcancel_urld'une session d'abonnement peuvent être des URLhttpsurlocalhost,127.0.0.1ou[::1]. Le mode Production n'accepte quehttps. - Une nouvelle application Test ne copie pas l'URL du webhook de l'application en production. Définissez-en une pour Test séparément, sous Webhooks en mode Test.
Paiements de test
Une application Test peut toujours encaisser des paiements via le simulateur Abuna. Un propriétaire d'équipe peut aussi connecter le bac à sable de chaque prestataire, MeSomb, pawaPay, Notch Pay, Flutterwave et Fapshi, comme comptes Test sur la page Comptes de paiement de l'équipe, et les utiliser côte à côte, un par prestataire. La page Paiements, sous Paramètres en mode Test, liste le simulateur et chaque bac à sable que l'application utilise. Chaque compte de bac à sable a sa propre URL du webhook pour le prestataire, partagée par toutes les applications Test qui l'utilisent.
Sur une page de paiement Test, le payeur choisit sous Tester avec : Simulateur Abuna, par défaut, ou un bac à sable connecté, comme bac à sable pawaPay. Les pages de paiement en production n'offrent jamais ce choix.
- Simulateur Abuna : vous choisissez chaque résultat sur la page de paiement. Voyez Paiements simulés.
- Un bac à sable de prestataire : la page de paiement propose les réseaux du prestataire, un champ de numéro de téléphone et les numéros de test du prestataire. Choisir un numéro de test remplit le numéro de téléphone et son réseau. Les paiements sont mis à jour et échouent selon ce que le prestataire rapporte. Voyez Numéros de test.
Connectez un bac à sable pour voir comment votre prestataire se comporte avant de passer en production. Le déconnecter laisse le simulateur et vos autres bacs à sable tels quels. Les deux sont gratuits et illimités sur tous les forfaits. Voyez Testez avec le bac à sable de votre prestataire.
Paiements simulés
Le simulateur Abuna a une méthode de paiement par résultat. Sur la page de paiement Test, le client en choisit une :
- Successful payment (
test) : le paiement réussit. - Needs approval, then succeeds (
test_pending) : le paiement est d'abordpending, comme une demande de mobile money. Il réussit environ 10 secondes plus tard, et la page de paiement se met à jour d'elle-même. - Declined payment (
test_declined) : échoue avec402et le codepayment_declined. - Insufficient balance (
test_insufficient) : échoue avec402et le codeinsufficient_funds.
Quand votre serveur débite une facture avec POST /v1/apps/{appID}/invoices/{id}/charge, une application Test utilise toujours la méthode test du simulateur, donc le paiement réussit.
Pour essayer un autre résultat sans la page de paiement, envoyez-le à l'endpoint du lien de paiement. Cet endpoint ne demande aucune clé. Utilisez le pay_token de la période de facturation.
curl https://api.abuna.app/v1/pay/3a7e1c9f5b2d8a4e6c0f7b3d9a1e5c8f2b6d \
-H "Content-Type: application/json" \
-d '{"method": "test_declined"}'{
"code": "payment_declined",
"error": "payment was declined"
}Pour payer plutôt via un bac à sable connecté, ajoutez provider : mesomb, pawapay, notchpay, flutterwave ou fapshi. Laissez-le de côté pour le simulateur. method est alors l'un des réseaux du prestataire, et phone_number est le numéro à débiter au lieu de celui du client. Un prestataire que l'application Test n'a pas connecté renvoie 422 avec le code payment_unavailable, et il en va de même pour provider sur un lien de paiement en production.
curl https://api.abuna.app/v1/pay/3a7e1c9f5b2d8a4e6c0f7b3d9a1e5c8f2b6d \
-H "Content-Type: application/json" \
-d '{"provider": "pawapay", "method": "MTN_MOMO_CMR", "phone_number": "+237653456039"}'Numéros de test
Le bac à sable de chaque prestataire règle un paiement selon le numéro de téléphone débité. Les pages de paiement Test affichent les mêmes numéros que ces tableaux, pour le réseau choisi. La raison de l'échec que voit votre client dépend de ce que le prestataire rapporte.
- MeSomb : utilisez une application MeSomb encore en mode test. Une application Test ne débite que ces numéros. Chaque réseau a ses propres numéros de test, et un même numéro peut donner un autre résultat sur un autre réseau, donc choisissez le numéro indiqué pour le réseau que vous testez. Voir la page du mode test de MeSomb.
- pawaPay : le bac à sable ne demande jamais de code PIN. Un numéro qui ne reçoit pas de réponse reste
pending. Voir les numéros de test de pawaPay. - Notch Pay : le dernier chiffre détermine le résultat. Notch Pay vérifie aussi la fraude dans son bac à sable, donc n'utilisez pas un seul numéro pour tous les tests. Voir la page de test de Notch Pay.
- Flutterwave : son mode test valide chaque paiement mobile money après quelques secondes, quel que soit le numéro. Il n'a aucun numéro qui fait échouer un paiement au Cameroun, utilisez donc le simulateur Abuna pour tester les échecs. Voir la page de test de Flutterwave.
- Fapshi : chaque réseau a trois numéros qui réussissent et trois qui échouent. Tout autre numéro donne un résultat au hasard, alors utilisez un numéro de la liste. Voir les numéros de test de Fapshi.
MeSomb
| Numéro | Réseau | Ce qui se passe |
|---|---|---|
+237600000001 | MTN Mobile Money Cameroon | Réussit |
+237600000002 | MTN Mobile Money Cameroon | Pas de réponse, reste en attente |
+237600000019 | MTN Mobile Money Cameroon | Échoue : plafond du compte atteint |
+237600000029 | MTN Mobile Money Cameroon | Échoue : pas de compte mobile money |
+237600000039 | MTN Mobile Money Cameroon | Échoue : refusé |
+237600000069 | MTN Mobile Money Cameroon | Échoue : refusé |
+237600000001 | Orange Money Cameroon | Réussit |
+237600000002 | Orange Money Cameroon | Pas de réponse, reste en attente |
+237600000019 | Orange Money Cameroon | Échoue : plafond du compte atteint |
+237600000029 | Orange Money Cameroon | Échoue : pas de compte mobile money |
+237600000039 | Orange Money Cameroon | Échoue : refusé |
+237600000049 | Orange Money Cameroon | Échoue : solde insuffisant |
+237600000069 | Orange Money Cameroon | Échoue : refusé |
+2250000000001 | MTN Mobile Money Côte d'Ivoire | Réussit |
+2250000000002 | MTN Mobile Money Côte d'Ivoire | Pas de réponse, reste en attente |
+2250000000029 | MTN Mobile Money Côte d'Ivoire | Échoue : pas de compte mobile money |
+2250000000039 | MTN Mobile Money Côte d'Ivoire | Échoue : refusé |
+2250000000069 | MTN Mobile Money Côte d'Ivoire | Échoue : refusé |
+2250000000001 | Orange Money Côte d'Ivoire | Réussit |
+2250000000002 | Orange Money Côte d'Ivoire | Pas de réponse, reste en attente |
+2250000000030 | Orange Money Côte d'Ivoire | Échoue : refusé |
+2250000000060 | Orange Money Côte d'Ivoire | Échoue : refusé |
+22600000001 | Moov Money Burkina Faso | Réussit |
+22600000002 | Moov Money Burkina Faso | Pas de réponse, reste en attente |
+22600000048 | Moov Money Burkina Faso | Échoue : solde insuffisant |
+22600000068 | Moov Money Burkina Faso | Échoue : refusé |
pawaPay
| Numéro | Réseau | Ce qui se passe |
|---|---|---|
+237653456789 | MTN Mobile Money Cameroon | Réussit |
+237653456129 | MTN Mobile Money Cameroon | Pas de réponse, reste en attente |
+237653456019 | MTN Mobile Money Cameroon | Échoue : plafond du compte atteint |
+237653456029 | MTN Mobile Money Cameroon | Échoue : pas de compte mobile money |
+237653456039 | MTN Mobile Money Cameroon | Échoue : non validé sur le téléphone |
+237653456069 | MTN Mobile Money Cameroon | Échoue : refusé |
+237693456789 | Orange Money Cameroon | Réussit |
+237693456129 | Orange Money Cameroon | Pas de réponse, reste en attente |
+237693456019 | Orange Money Cameroon | Échoue : plafond du compte atteint |
+237693456029 | Orange Money Cameroon | Échoue : pas de compte mobile money |
+237693456039 | Orange Money Cameroon | Échoue : non validé sur le téléphone |
+237693456049 | Orange Money Cameroon | Échoue : solde insuffisant |
+237693456069 | Orange Money Cameroon | Échoue : refusé |
+2250503456789 | MTN Mobile Money Côte d'Ivoire | Réussit |
+2250503456129 | MTN Mobile Money Côte d'Ivoire | Pas de réponse, reste en attente |
+2250503456029 | MTN Mobile Money Côte d'Ivoire | Échoue : pas de compte mobile money |
+2250503456039 | MTN Mobile Money Côte d'Ivoire | Échoue : non validé sur le téléphone |
+2250503456069 | MTN Mobile Money Côte d'Ivoire | Échoue : refusé |
+2250734567890 | Orange Money Côte d'Ivoire | Réussit |
+2250734567130 | Orange Money Côte d'Ivoire | Pas de réponse, reste en attente |
+2250734567030 | Orange Money Côte d'Ivoire | Échoue : non validé sur le téléphone |
+2250734567060 | Orange Money Côte d'Ivoire | Échoue : refusé |
+221773456789 | Orange Money Senegal | Réussit |
+221773456129 | Orange Money Senegal | Pas de réponse, reste en attente |
+221773456029 | Orange Money Senegal | Échoue : pas de compte mobile money |
+221773456049 | Orange Money Senegal | Échoue : solde insuffisant |
+221773456069 | Orange Money Senegal | Échoue : refusé |
+221763456789 | Free Money Senegal | Réussit |
+221763456129 | Free Money Senegal | Pas de réponse, reste en attente |
+221763456049 | Free Money Senegal | Échoue : solde insuffisant |
+221763456069 | Free Money Senegal | Échoue : refusé |
+2290151345789 | MTN Mobile Money Benin | Réussit |
+2290151345129 | MTN Mobile Money Benin | Pas de réponse, reste en attente |
+2290151345029 | MTN Mobile Money Benin | Échoue : pas de compte mobile money |
+2290151345039 | MTN Mobile Money Benin | Échoue : non validé sur le téléphone |
+2290151345069 | MTN Mobile Money Benin | Échoue : refusé |
+2290195345789 | Moov Money Benin | Réussit |
+2290195345639 | Moov Money Benin | Pas de réponse, reste en attente |
+2290195345679 | Moov Money Benin | Échoue : non validé sur le téléphone |
+2290195345529 | Moov Money Benin | Échoue : refusé |
+22602345678 | Moov Money Burkina Faso | Réussit |
+22602345138 | Moov Money Burkina Faso | Pas de réponse, reste en attente |
+22602345048 | Moov Money Burkina Faso | Échoue : solde insuffisant |
+22602345068 | Moov Money Burkina Faso | Échoue : refusé |
Notch Pay
| Numéro | Réseau | Ce qui se passe |
|---|---|---|
+237670000000 | MTN Mobile Money Cameroon | Réussit |
+237670000001 | MTN Mobile Money Cameroon | Échoue : solde insuffisant |
+237670000002 | MTN Mobile Money Cameroon | Échoue : refusé |
+237670000003 | MTN Mobile Money Cameroon | Pas de réponse, reste en attente |
+237670000004 | MTN Mobile Money Cameroon | Échoue : non validé sur le téléphone |
+237690000000 | Orange Money Cameroon | Réussit |
+237690000001 | Orange Money Cameroon | Échoue : solde insuffisant |
+237690000002 | Orange Money Cameroon | Échoue : refusé |
+237690000003 | Orange Money Cameroon | Pas de réponse, reste en attente |
+237690000004 | Orange Money Cameroon | Échoue : non validé sur le téléphone |
+225050000000 | MTN Mobile Money Côte d'Ivoire | Réussit |
+225050000001 | MTN Mobile Money Côte d'Ivoire | Échoue : solde insuffisant |
+225050000002 | MTN Mobile Money Côte d'Ivoire | Échoue : refusé |
+225050000003 | MTN Mobile Money Côte d'Ivoire | Pas de réponse, reste en attente |
+225050000004 | MTN Mobile Money Côte d'Ivoire | Échoue : non validé sur le téléphone |
+225070000000 | Orange Money Côte d'Ivoire | Réussit |
+225070000001 | Orange Money Côte d'Ivoire | Échoue : solde insuffisant |
+225070000002 | Orange Money Côte d'Ivoire | Échoue : refusé |
+225070000003 | Orange Money Côte d'Ivoire | Pas de réponse, reste en attente |
+225070000004 | Orange Money Côte d'Ivoire | Échoue : non validé sur le téléphone |
+225010000000 | Moov Money Côte d'Ivoire | Réussit |
+225010000001 | Moov Money Côte d'Ivoire | Échoue : solde insuffisant |
+225010000002 | Moov Money Côte d'Ivoire | Échoue : refusé |
+225010000003 | Moov Money Côte d'Ivoire | Pas de réponse, reste en attente |
+225010000004 | Moov Money Côte d'Ivoire | Échoue : non validé sur le téléphone |
+221770000000 | Orange Money Senegal | Réussit |
+221770000001 | Orange Money Senegal | Échoue : solde insuffisant |
+221770000002 | Orange Money Senegal | Échoue : refusé |
+221770000003 | Orange Money Senegal | Pas de réponse, reste en attente |
+221770000004 | Orange Money Senegal | Échoue : non validé sur le téléphone |
+221760000000 | Free Money Senegal | Réussit |
+221760000001 | Free Money Senegal | Échoue : solde insuffisant |
+221760000002 | Free Money Senegal | Échoue : refusé |
+221760000003 | Free Money Senegal | Pas de réponse, reste en attente |
+221760000004 | Free Money Senegal | Échoue : non validé sur le téléphone |
+2290190000000 | MTN Mobile Money Benin | Réussit |
+2290190000001 | MTN Mobile Money Benin | Échoue : solde insuffisant |
+2290190000002 | MTN Mobile Money Benin | Échoue : refusé |
+2290190000003 | MTN Mobile Money Benin | Pas de réponse, reste en attente |
+2290190000004 | MTN Mobile Money Benin | Échoue : non validé sur le téléphone |
+2290191000000 | Moov Money Benin | Réussit |
+2290191000001 | Moov Money Benin | Échoue : solde insuffisant |
+2290191000002 | Moov Money Benin | Échoue : refusé |
+2290191000003 | Moov Money Benin | Pas de réponse, reste en attente |
+2290191000004 | Moov Money Benin | Échoue : non validé sur le téléphone |
+226710000000 | Moov Money Burkina Faso | Réussit |
+226710000001 | Moov Money Burkina Faso | Échoue : solde insuffisant |
+226710000002 | Moov Money Burkina Faso | Échoue : refusé |
+226710000003 | Moov Money Burkina Faso | Pas de réponse, reste en attente |
+226710000004 | Moov Money Burkina Faso | Échoue : non validé sur le téléphone |
Flutterwave
| Numéro | Réseau | Ce qui se passe |
|---|---|---|
+237670000000 | MTN Mobile Money Cameroon | Réussit |
+237690000000 | Orange Money Cameroon | Réussit |
+2250500000000 | MTN Mobile Money Côte d'Ivoire | Réussit |
+2250100000000 | Moov Money Côte d'Ivoire | Réussit |
+22660000000 | Moov Money Burkina Faso | Réussit |
Fapshi
| Numéro | Réseau | Ce qui se passe |
|---|---|---|
+237670000000 | MTN Mobile Money Cameroon | Réussit |
+237670000002 | MTN Mobile Money Cameroon | Réussit |
+237650000000 | MTN Mobile Money Cameroon | Réussit |
+237670000001 | MTN Mobile Money Cameroon | Échoue : refusé |
+237670000003 | MTN Mobile Money Cameroon | Échoue : refusé |
+237650000001 | MTN Mobile Money Cameroon | Échoue : refusé |
+237690000000 | Orange Money Cameroon | Réussit |
+237690000002 | Orange Money Cameroon | Réussit |
+237656000000 | Orange Money Cameroon | Réussit |
+237690000001 | Orange Money Cameroon | Échoue : refusé |
+237690000003 | Orange Money Cameroon | Échoue : refusé |
+237656000001 | Orange Money Cameroon | Échoue : refusé |
Mode Production
Le mode Production facture de vrais clients avec l'ID d'application Production et sa clé sk_live_. Avant qu'il fonctionne, trois éléments sont nécessaires :
- Un e-mail vérifié pour le propriétaire d'équipe. D'ici là, chaque endpoint de Production sauf
GET /v1/apps/{appID}renvoie403avec le codeemail_unverified. - Un moyen d'encaisser. Connectez votre compte MeSomb, pawaPay, Notch Pay, Flutterwave ou Fapshi à votre équipe dans le tableau de bord et choisissez-le dans l'application en production, ou activez Paiements Abuna. D'ici là, vous pouvez configurer des produits, des prix et des clients. Démarrer un abonnement ou encaisser un paiement renvoie
422avec le codenot_accepting_payments. - Un contact de support. Ajoutez un e-mail ou une URL de support sous Paramètres, puis Général. D'ici là, démarrer un abonnement ou encaisser un paiement renvoie
422avec le codenot_accepting_payments.
GET /v1/apps/{appID} indique où vous en êtes. Son objet payments contient email_verified, provider_connected, support_contact et ready.
En mode Production, le client approuve chaque paiement sur son téléphone. Avec votre propre compte de paiement, vos clients paient directement sur ce compte, et Abuna ne détient jamais l'argent. Avec Paiements Abuna, Abuna encaisse l'argent et vous le verse chaque matin à 08:00, heure du Cameroun, contre des frais de 3,5 %. Voyez Connecter un prestataire de paiement.
Passer en production
Changez l'ID d'application et la clé secrète ensemble. Votre code reste le même. Le mode Production démarre sans données : les produits, prix, clients et abonnements ne sont pas repris depuis Test, recréez-les donc en production. Définissez l'URL de votre webhook de Production et utilisez le secret de signature de Production pour vérifier les signatures.
Vous pouvez copier vos produits et vos prix de Test vers Production, et de Production vers Test. Dans le tableau de bord, ouvrez Produits dans le mode d'où vous copiez, ou utilisez l'API. Voir Copier entre Test et Production.
Étapes suivantes
- Authentification et clés d'APIAuthentifiez vos requêtes avec votre clé secrète, et sachez quelle clé va où.
- Connecter un prestataire de paiementConnectez votre propre compte MeSomb, pawaPay, Notch Pay, Flutterwave ou Fapshi, ou utilisez Paiements Abuna.
- Avant de passer en productionTout ce qu'il faut vérifier avant d'encaisser de vrais paiements.