# Avant de passer en production > Tout ce qu'il faut vérifier avant d'encaisser de vrais paiements. Source : https://abuna.app/docs/guides/going-live?hl=fr 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. **403 email_unverified** ```json { "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](https://abuna.app/docs/guides/payment-providers.md?hl=fr#abuna-payments). 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](https://abuna.app/docs/guides/payment-providers.md?hl=fr#get-your-credentials). 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`. > **Remarque :** Abuna n'envoie jamais d'argent depuis votre compte et stocke vos identifiants chiffrés. Avant de partager une clé, suivez les [conseils sur les identifiants](https://abuna.app/docs/guides/payment-providers.md?hl=fr#get-your-credentials) pour votre prestataire. **422 not_accepting_payments** ```json { "code": "not_accepting_payments", "error": "this app isn't accepting payments yet" } ``` Voyez [Connecter un prestataire de paiement](https://abuna.app/docs/guides/payment-providers.md?hl=fr) 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](https://abuna.app/docs/guides/payment-providers.md?hl=fr#set-the-provider-webhook). ## 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_`. **Une requête en mode Production** ```bash 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](https://abuna.app/docs/api/products.md?hl=fr#copy-from-test). ## 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 tout `v1` qui correspond, et rejetez un `t` dé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 `environment` dans le corps signé, pas seulement selon l'en-tête `X-Abuna-Environment`. Voyez [Recevoir des webhooks](https://abuna.app/docs/guides/webhooks.md?hl=fr) 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 `https` absolue. Les `success_url` et `cancel_url` que vous passez à une session de paiement doivent aussi être en `https` en mode Production. Une URL `localhost` qui fonctionnait en mode Test renvoie `422`. - **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. > **Remarque :** Voyez [Forfaits et limites](https://abuna.app/docs/guides/plans-and-limits.md?hl=fr) pour les limites de chaque forfait et ce qui se passe quand vous en atteignez une. ## 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.