Ce qui change entre les deux
Le sandbox sert à intégrer et à tester sans attendre d’approbation. Le live ouvre après le KYC, car c’est là que de l’argent réel circule.
Dans le tableau de bord, le sélecteur Sandbox / Live en haut de page choisit les données affichées. Un endpoint de webhook peut écouter le sandbox, le live ou les deux, voir Webhooks.
Clés sandbox et live
Une clé sandbox reste lisible : copiez-la quand vous voulez depuis la console Développeurs. Une clé live ne s’affiche qu’une seule fois, à sa création. Gardez-la dans vos secrets serveur.Tester un paiement
En sandbox, la page de paiement affiche directement les données de test. Choisissez Paiement réussi ou Paiement refusé pour le mobile money, ou copiez la carte de test.Carte
Mobile money
Ces numéros ne fonctionnent qu’en sandbox. Chacun donne toujours le même résultat.
Moov Money Gabon, M-Pesa Mozambique : pas encore de numéro de test. Testez sur un autre opérateur.
Tester les cas difficiles
Une cause d’échec précise
Sur la page de paiement sandbox, des boutons remplissent le numéro qui produit chaque cause, quand l’opérateur la propose : Solde insuffisant, Refusé par le client, Plafond atteint, Numéro inconnu, ou Reste en attente pour un paiement qui ne se conclut pas. Le paiement échoue avec lefailure_code correspondant, et votre webhook payment.failed le reçoit.
Un retrait
Un retrait sandbox part tout de suite, sans examen et sans KYC, depuis votre solde de test. Vers le numéro de réussite de l’opérateur, il passe àpaid. Pour un échec, utilisez le numéro de retrait refusé :
Vous recevez
payout.paid ou payout.failed, comme en live.
Un renouvellement d’abonnement
Sans attendre la vraie date : sur un abonnement sandbox, Gérer puis Passer à l’échéance (test), ouPOST /api/v1/subscriptions/{id}/advance. La facture est créée et son paiement lancé tout de suite.