Guides
Avant de passer en production
Tout ce qu'il faut vérifier avant d'encaisser de vrais paiements.
Cette liste vous permet de faire passer votre application du mode Test au mode Production. Chaque mode a son propre ID d'application, ses clés, son catalogue, son URL de webhook et ses données : la plupart de ce que vous configurez en mode Test n'est donc pas repris. Parcourez cette liste en mode Production avant d'encaisser de vrais paiements.
1. Confirmez l'adresse e-mail du propriétaire de l'équipe
Le mode Production ne fonctionne qu'une fois que le propriétaire de l'équipe a confirmé son adresse e-mail. En attendant, les requêtes en mode Production renvoient 403 avec le code email_unverified, et les clients ne peuvent pas payer. Le mode Test fonctionne sans cela.
{
"code": "email_unverified",
"error": "the team owner must verify their email to use live"
}2. Choisissez comment vos clients paient
En mode Production, votre application encaisse via votre propre compte MeSomb, pawaPay, Notch Pay, Flutterwave ou Fapshi. Dans le tableau de bord, connectez-le comme compte de production sur la page Comptes de paiement de votre équipe. Ensuite, en mode Production, ouvrez les Paramètres de votre application, puis Paiements, cliquez sur Choisir un compte, puis choisissez-le. Vous pouvez aussi cliquer sur Connecter un nouveau compte sur cette page.
Les comptes de paiement appartiennent à votre équipe, donc plusieurs applications peuvent utiliser le même. Si une autre de vos applications utilise déjà un compte de production, vous pouvez aussi le choisir ici, et son URL du webhook pour le prestataire reste la même.
Pas de compte de paiement ? Choisissez plutôt Paiements Abuna dans les mêmes paramètres Paiements. Abuna encaisse l'argent contre 3,5 % de frais et vous le verse chaque matin sur votre numéro mobile money : vous pouvez alors sauter la suite de cette étape et l'étape 3. Voyez Paiements Abuna.
Utilisez des identifiants de production. Si vous avez testé avec le bac à sable de votre prestataire, ces identifiants ne fonctionnent pas ici : les clés de bac à sable Notch Pay et les clés de test Flutterwave échouent avec le code provider_live_credentials_required, et pawaPay refuse un jeton de bac à sable avec provider_credentials_rejected. pawaPay ne crée un jeton qu'une fois qu'une callback URL est définie, alors définissez d'abord une URL temporaire, puis remplacez-la à l'étape 3.
Pour MeSomb, connectez une application que MeSomb a approuvée pour les paiements en production. MeSomb utilise les mêmes clés en mode test, donc Abuna ne peut pas repérer la mauvaise. Un compte de production avec une application encore en mode test n'encaisse rien, et le mode Production refuse les numéros de test de MeSomb. Laissez le secret de signature Webhook vide pour l'instant : vous l'ajoutez à l'étape 3.
Pour Fapshi, connectez les clés de production de votre service de collecte, et vérifiez que Fapshi a activé Direct Pay sur votre compte. D'ici là, Fapshi refuse vos paiements en production. Voyez Obtenez vos identifiants.
Tant que votre application n'utilise ni compte de paiement ni Paiements Abuna en mode Production, les pages d'abonnement et les paiements renvoient 422 avec le code not_accepting_payments.
{
"code": "not_accepting_payments",
"error": "this app isn't accepting payments yet"
}Voyez Connecter un prestataire de paiement pour les identifiants dont chaque prestataire a besoin.
3. Définissez l'URL du webhook pour le prestataire
Cette étape est obligatoire avec votre propre compte de paiement. Après la connexion, le compte affiche une URL du webhook pour le prestataire. Collez-la dans le tableau de bord de votre prestataire, pour que les paiements se mettent à jour dès que les clients les valident. Tant qu'elle n'est pas définie, les paiements peuvent ne pas se mettre à jour dans Abuna, et les factures payées peuvent rester ouvertes.
- MeSomb : ouvrez Paramètres développeur, ajoutez un webhook avec l'URL, et copiez son secret de signature. MeSomb ne l'affiche qu'une fois. Dans Abuna, choisissez Remplacer les clés sur le compte et collez-le comme secret de signature Webhook. Avec lui, les paiements MeSomb sont confirmés en quelques secondes. D'ici là, ils sont tout de même confirmés automatiquement, en général dans l'heure, mais certains peuvent prendre plusieurs heures.
- pawaPay : ouvrez System configuration, puis Callback URLs, et collez-la comme Deposits callback URL, à la place de l'URL temporaire.
- Notch Pay : ouvrez Paramètres, puis Webhooks, ajoutez un webhook avec l'URL, et activez les événements de paiement. Si Notch Pay affiche ensuite une autre clé de hachage pour ce webhook, saisissez-la dans Abuna comme clé de hachage Webhook.
- Flutterwave : ouvrez Paramètres, puis Webhooks, collez l'URL, et saisissez le même hachage secret que celui entré dans Abuna. Cochez Activer les nouvelles tentatives de webhook et Activer le webhook pour les transactions échouées, puis enregistrez.
- Fapshi : ouvrez Développeurs, puis votre service de collecte. Collez l'URL comme URL de webhook, saisissez le même secret Webhook que celui entré dans Abuna, puis enregistrez.
Ensuite, sur le compte, cochez J'ai ajouté cette URL dans votre prestataire. Pour MeSomb, enregistrer le secret de signature le fait pour vous. Aucun paiement n'est nécessaire : une fois cette étape et les étapes 1, 2 et 4 faites, le tableau de bord ouvre votre application en mode Production. Votre premier paiement réel (étape 10) apporte la première mise à jour de votre prestataire. Voyez Définissez l'URL du webhook pour le prestataire.
4. Ajoutez un contact d'assistance
Votre application n'encaisse en mode Production qu'une fois qu'elle a un e-mail d'assistance ou une page d'aide. Dans le tableau de bord, ouvrez Paramètres, puis Général, et remplissez Assistance client. Le mode Test et le mode Production la partagent. Tant qu'il n'est pas défini, les pages d'abonnement et les liens de paiement renvoient 422 avec le code not_accepting_payments.
Tant qu'il n'y a pas de contact d'assistance, aucun abonnement n'est résilié pour non-paiement, et les factures de renouvellement restent ouvertes. Une fois que vous en ajoutez un, les clients avec un renouvellement impayé retrouvent tout leur délai de paiement à partir de ce moment.
5. Passez à l'ID et à la clé de production
Votre serveur choisit le mode selon l'ID d'application dans le chemin et la clé qu'il envoie. Changez les deux ensemble : l'ID de l'application en production, et une clé secrète qui commence par sk_live_.
curl https://api.abuna.app/v1/apps/Q7mKp2Rt/products \
-H "Authorization: Bearer sk_live_..."- Abuna affiche une clé secrète une seule fois, à sa création. Un propriétaire d'équipe peut en créer d'autres sous Paramètres, Clés d'API, et révoquer une clé qui fuite.
- Gardez les clés secrètes sur votre serveur. Ne les mettez jamais dans un navigateur ou une application mobile.
6. Créez vos produits et vos prix en mode Production
Le mode Production démarre vide. Créez à nouveau vos produits et vos prix en mode Production, et conservez leurs ID de production. Les ID Test n'existent pas en mode Production.
Ou copiez-les depuis Test : dans le tableau de bord, ouvrez Produits en mode Test, ou utilisez l'API. Voir Copier les produits de Test vers Production.
7. Configurez votre URL de webhook de production
Chaque mode a sa propre URL de webhook : le mode Production ne reprend pas celle de Test. En mode Production, ouvrez Webhooks et définissez l'URL du webhook. Elle doit être une URL https publique.
- Utilisez le secret de signature de production, qui commence par
whsec_live_. Votre secret Test ne vérifie pas les événements de production. - Vérifiez
X-Abuna-Signatureà chaque requête, acceptez toutv1qui correspond, et rejetez untdécalé de plus de 300 secondes. - Cliquez sur Envoyer un événement de test et vérifiez que votre serveur répond
2xx. - Si un même serveur gère les deux modes, acheminez selon
environmentdans le corps signé, pas seulement selon l'en-têteX-Abuna-Environment.
Voyez Recevoir des webhooks pour la configuration complète.
8. Vérifiez vos réglages de production
Le nom de votre application, le contact d'assistance et l'URL des conditions sont partagés par les deux modes. Ses URL de redirection, son délai de paiement et son URL de webhook se règlent par mode. En mode Production, ouvrez Paramètres, puis Général :
- Assistance client : un e-mail d'assistance ou une page d'aide, obligatoire avant que votre application n'encaisse en mode Production. Il apparaît dans chaque e-mail client, et sur votre page d'abonnement, vos liens de paiement et votre espace client.
- URL de redirection : où la page d'abonnement renvoie les clients. Chacune doit être une URL
httpsabsolue. Lessuccess_urletcancel_urlque vous passez à une session de paiement doivent aussi être enhttpsen mode Production. Une URLlocalhostqui fonctionnait en mode Test renvoie422. - Renouvellements et délai de paiement : combien de jours avant la fin d'une période payée part la facture de renouvellement (de 0 à 7, 3 par défaut). Et combien de jours vos clients ont pour payer un renouvellement, de 1 à 14. Si un renouvellement reste impayé au-delà, Abuna résilie l'abonnement et prévient le client. Les deux s'appliquent aux factures émises après votre changement.
- Quand les clients résilient : si un client qui résilie depuis l'espace client garde l'abonnement jusqu'à la fin de la période payée (par défaut) ou le perd immédiatement. Le mode Test et le mode Production ont chacun leur propre réglage.
9. Vérifiez le forfait de votre équipe
Seul le mode Production compte dans le forfait de votre équipe. Le forfait Free permet 20 abonnés et 1 application, et les équipes au forfait Free que vous avez créées se partagent cette application. À la limite, les nouveaux clients ne peuvent pas s'abonner, et votre page d'abonnement leur dit que vous n'acceptez pas de nouveaux abonnés. Si vous en attendez plus, passez à un forfait plus grand avant de lancer.
10. Faites un vrai paiement
Abonnez-vous à votre propre produit avec un petit prix, via une session de paiement, et payez-le avec votre propre compte mobile money. Vérifiez que vous recevez l'e-mail de reçu, que votre serveur reçoit session.completed, invoice.paid et subscription.paid, et que l'argent arrive sur votre compte de paiement. La page Paiements doit alors indiquer Mises à jour reçues. Avec Paiements Abuna, l'argent arrive sur votre numéro mobile money avec le versement du lendemain matin, dès que votre solde dépasse 100 FCFA.
Étapes suivantes
- Connecter un prestataire de paiementConnectez votre propre compte MeSomb, pawaPay, Notch Pay, Flutterwave ou Fapshi, ou utilisez Paiements Abuna.
- Recevoir des webhooksRecevez les événements sur votre serveur et vérifiez qu'Abuna les a envoyés.
- Forfaits et limitesCe que chaque forfait Abuna comprend, et ce qui se passe quand vous dépassez une limite.
- Mode Test et mode ProductionDé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.