# 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. Source : https://abuna.app/docs/test-and-live-mode?hl=fr 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](https://abuna.app/docs/test-and-live-mode.md?hl=fr#test-payments). - 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](https://abuna.app/docs/guides/customer-notifications.md?hl=fr#test-mode). 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](https://abuna.app/docs/test-and-live-mode.md?hl=fr#simulated-payments). - **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](https://abuna.app/docs/test-and-live-mode.md?hl=fr#test-numbers). 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](https://abuna.app/docs/guides/payment-providers.md?hl=fr#test-with-a-sandbox). ## 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é** ```bash curl https://api.abuna.app/v1/pay/3a7e1c9f5b2d8a4e6c0f7b3d9a1e5c8f2b6d \ -H "Content-Type: application/json" \ -d '{"method": "test_declined"}' ``` **Réponse (402)** ```json { "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** ```bash 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](https://docs.mesomb.com/development/test-mode) 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](https://docs.pawapay.io/v2/docs/test_numbers) 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](https://developer.notchpay.co/get-started/testing) 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](https://developer.flutterwave.com/docs/testing) 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](https://docs.fapshi.com/fr/api-reference/preliminary-knowledge/environment) 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 : 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](https://abuna.app/docs/guides/payment-providers.md?hl=fr). ## 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](https://abuna.app/docs/api/products.md?hl=fr#copy).