Skip to content
ABUNA
DocumentationMode Test et mode Production

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.

Voir en Markdown

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_url et cancel_url d'une session d'abonnement peuvent être des URL http sur localhost, 127.0.0.1 ou [::1]. Le mode Production n'accepte que https.
  • 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'abord pending, 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 avec 402 et le code payment_declined.
  • Insufficient balance (test_insufficient) : échoue avec 402 et le code insufficient_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.

Simuler un paiement refusé
curl https://api.abuna.app/v1/pay/3a7e1c9f5b2d8a4e6c0f7b3d9a1e5c8f2b6d \
  -H "Content-Type: application/json" \
  -d '{"method": "test_declined"}'
Réponse 402
{
  "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.

Simuler un paiement que le payeur n'approuve pas
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éroRéseauCe qui se passe
+237600000001MTN Mobile Money CameroonRéussit
+237600000002MTN Mobile Money CameroonPas de réponse, reste en attente
+237600000019MTN Mobile Money CameroonÉchoue : plafond du compte atteint
+237600000029MTN Mobile Money CameroonÉchoue : pas de compte mobile money
+237600000039MTN Mobile Money CameroonÉchoue : refusé
+237600000069MTN Mobile Money CameroonÉchoue : refusé
+237600000001Orange Money CameroonRéussit
+237600000002Orange Money CameroonPas de réponse, reste en attente
+237600000019Orange Money CameroonÉchoue : plafond du compte atteint
+237600000029Orange Money CameroonÉchoue : pas de compte mobile money
+237600000039Orange Money CameroonÉchoue : refusé
+237600000049Orange Money CameroonÉchoue : solde insuffisant
+237600000069Orange Money CameroonÉchoue : refusé
+2250000000001MTN Mobile Money Côte d'IvoireRéussit
+2250000000002MTN Mobile Money Côte d'IvoirePas de réponse, reste en attente
+2250000000029MTN Mobile Money Côte d'IvoireÉchoue : pas de compte mobile money
+2250000000039MTN Mobile Money Côte d'IvoireÉchoue : refusé
+2250000000069MTN Mobile Money Côte d'IvoireÉchoue : refusé
+2250000000001Orange Money Côte d'IvoireRéussit
+2250000000002Orange Money Côte d'IvoirePas de réponse, reste en attente
+2250000000030Orange Money Côte d'IvoireÉchoue : refusé
+2250000000060Orange Money Côte d'IvoireÉchoue : refusé
+22600000001Moov Money Burkina FasoRéussit
+22600000002Moov Money Burkina FasoPas de réponse, reste en attente
+22600000048Moov Money Burkina FasoÉchoue : solde insuffisant
+22600000068Moov Money Burkina FasoÉchoue : refusé

pawaPay

NuméroRéseauCe qui se passe
+237653456789MTN Mobile Money CameroonRéussit
+237653456129MTN Mobile Money CameroonPas de réponse, reste en attente
+237653456019MTN Mobile Money CameroonÉchoue : plafond du compte atteint
+237653456029MTN Mobile Money CameroonÉchoue : pas de compte mobile money
+237653456039MTN Mobile Money CameroonÉchoue : non validé sur le téléphone
+237653456069MTN Mobile Money CameroonÉchoue : refusé
+237693456789Orange Money CameroonRéussit
+237693456129Orange Money CameroonPas de réponse, reste en attente
+237693456019Orange Money CameroonÉchoue : plafond du compte atteint
+237693456029Orange Money CameroonÉchoue : pas de compte mobile money
+237693456039Orange Money CameroonÉchoue : non validé sur le téléphone
+237693456049Orange Money CameroonÉchoue : solde insuffisant
+237693456069Orange Money CameroonÉchoue : refusé
+2250503456789MTN Mobile Money Côte d'IvoireRéussit
+2250503456129MTN Mobile Money Côte d'IvoirePas de réponse, reste en attente
+2250503456029MTN Mobile Money Côte d'IvoireÉchoue : pas de compte mobile money
+2250503456039MTN Mobile Money Côte d'IvoireÉchoue : non validé sur le téléphone
+2250503456069MTN Mobile Money Côte d'IvoireÉchoue : refusé
+2250734567890Orange Money Côte d'IvoireRéussit
+2250734567130Orange Money Côte d'IvoirePas de réponse, reste en attente
+2250734567030Orange Money Côte d'IvoireÉchoue : non validé sur le téléphone
+2250734567060Orange Money Côte d'IvoireÉchoue : refusé
+221773456789Orange Money SenegalRéussit
+221773456129Orange Money SenegalPas de réponse, reste en attente
+221773456029Orange Money SenegalÉchoue : pas de compte mobile money
+221773456049Orange Money SenegalÉchoue : solde insuffisant
+221773456069Orange Money SenegalÉchoue : refusé
+221763456789Free Money SenegalRéussit
+221763456129Free Money SenegalPas de réponse, reste en attente
+221763456049Free Money SenegalÉchoue : solde insuffisant
+221763456069Free Money SenegalÉchoue : refusé
+2290151345789MTN Mobile Money BeninRéussit
+2290151345129MTN Mobile Money BeninPas de réponse, reste en attente
+2290151345029MTN Mobile Money BeninÉchoue : pas de compte mobile money
+2290151345039MTN Mobile Money BeninÉchoue : non validé sur le téléphone
+2290151345069MTN Mobile Money BeninÉchoue : refusé
+2290195345789Moov Money BeninRéussit
+2290195345639Moov Money BeninPas de réponse, reste en attente
+2290195345679Moov Money BeninÉchoue : non validé sur le téléphone
+2290195345529Moov Money BeninÉchoue : refusé
+22602345678Moov Money Burkina FasoRéussit
+22602345138Moov Money Burkina FasoPas de réponse, reste en attente
+22602345048Moov Money Burkina FasoÉchoue : solde insuffisant
+22602345068Moov Money Burkina FasoÉchoue : refusé

Notch Pay

NuméroRéseauCe qui se passe
+237670000000MTN Mobile Money CameroonRéussit
+237670000001MTN Mobile Money CameroonÉchoue : solde insuffisant
+237670000002MTN Mobile Money CameroonÉchoue : refusé
+237670000003MTN Mobile Money CameroonPas de réponse, reste en attente
+237670000004MTN Mobile Money CameroonÉchoue : non validé sur le téléphone
+237690000000Orange Money CameroonRéussit
+237690000001Orange Money CameroonÉchoue : solde insuffisant
+237690000002Orange Money CameroonÉchoue : refusé
+237690000003Orange Money CameroonPas de réponse, reste en attente
+237690000004Orange Money CameroonÉchoue : non validé sur le téléphone
+225050000000MTN Mobile Money Côte d'IvoireRéussit
+225050000001MTN Mobile Money Côte d'IvoireÉchoue : solde insuffisant
+225050000002MTN Mobile Money Côte d'IvoireÉchoue : refusé
+225050000003MTN Mobile Money Côte d'IvoirePas de réponse, reste en attente
+225050000004MTN Mobile Money Côte d'IvoireÉchoue : non validé sur le téléphone
+225070000000Orange Money Côte d'IvoireRéussit
+225070000001Orange Money Côte d'IvoireÉchoue : solde insuffisant
+225070000002Orange Money Côte d'IvoireÉchoue : refusé
+225070000003Orange Money Côte d'IvoirePas de réponse, reste en attente
+225070000004Orange Money Côte d'IvoireÉchoue : non validé sur le téléphone
+225010000000Moov Money Côte d'IvoireRéussit
+225010000001Moov Money Côte d'IvoireÉchoue : solde insuffisant
+225010000002Moov Money Côte d'IvoireÉchoue : refusé
+225010000003Moov Money Côte d'IvoirePas de réponse, reste en attente
+225010000004Moov Money Côte d'IvoireÉchoue : non validé sur le téléphone
+221770000000Orange Money SenegalRéussit
+221770000001Orange Money SenegalÉchoue : solde insuffisant
+221770000002Orange Money SenegalÉchoue : refusé
+221770000003Orange Money SenegalPas de réponse, reste en attente
+221770000004Orange Money SenegalÉchoue : non validé sur le téléphone
+221760000000Free Money SenegalRéussit
+221760000001Free Money SenegalÉchoue : solde insuffisant
+221760000002Free Money SenegalÉchoue : refusé
+221760000003Free Money SenegalPas de réponse, reste en attente
+221760000004Free Money SenegalÉchoue : non validé sur le téléphone
+2290190000000MTN Mobile Money BeninRéussit
+2290190000001MTN Mobile Money BeninÉchoue : solde insuffisant
+2290190000002MTN Mobile Money BeninÉchoue : refusé
+2290190000003MTN Mobile Money BeninPas de réponse, reste en attente
+2290190000004MTN Mobile Money BeninÉchoue : non validé sur le téléphone
+2290191000000Moov Money BeninRéussit
+2290191000001Moov Money BeninÉchoue : solde insuffisant
+2290191000002Moov Money BeninÉchoue : refusé
+2290191000003Moov Money BeninPas de réponse, reste en attente
+2290191000004Moov Money BeninÉchoue : non validé sur le téléphone
+226710000000Moov Money Burkina FasoRéussit
+226710000001Moov Money Burkina FasoÉchoue : solde insuffisant
+226710000002Moov Money Burkina FasoÉchoue : refusé
+226710000003Moov Money Burkina FasoPas de réponse, reste en attente
+226710000004Moov Money Burkina FasoÉchoue : non validé sur le téléphone

Flutterwave

NuméroRéseauCe qui se passe
+237670000000MTN Mobile Money CameroonRéussit
+237690000000Orange Money CameroonRéussit
+2250500000000MTN Mobile Money Côte d'IvoireRéussit
+2250100000000Moov Money Côte d'IvoireRéussit
+22660000000Moov Money Burkina FasoRéussit

Fapshi

NuméroRéseauCe qui se passe
+237670000000MTN Mobile Money CameroonRéussit
+237670000002MTN Mobile Money CameroonRéussit
+237650000000MTN Mobile Money CameroonRéussit
+237670000001MTN Mobile Money CameroonÉchoue : refusé
+237670000003MTN Mobile Money CameroonÉchoue : refusé
+237650000001MTN Mobile Money CameroonÉchoue : refusé
+237690000000Orange Money CameroonRéussit
+237690000002Orange Money CameroonRéussit
+237656000000Orange Money CameroonRéussit
+237690000001Orange Money CameroonÉchoue : refusé
+237690000003Orange Money CameroonÉchoue : refusé
+237656000001Orange 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 :

  1. Un e-mail vérifié pour le propriétaire d'équipe. D'ici là, chaque endpoint de Production sauf GET /v1/apps/{appID} renvoie 403 avec le code email_unverified.
  2. 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 422 avec le code not_accepting_payments.
  3. 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 422 avec le code not_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