Mode test
Chaque commerçant reçoit deux types de clé secrète. La clé seule détermine le mode : il n’y a aucun paramètre à passer.
sk_test_… |
sk_live_… |
|
|---|---|---|
| Prestataires | un connecteur fictif (mock) qui n’appelle jamais Wave ni Orange Money |
Wave, Orange Money |
| Argent | aucun ; les soldes sont tenus dans des comptes test: séparés du grand livre |
des XOF réels |
| Statut du commerçant | fonctionne tant que votre compte est pending_review |
exige active (sinon 403 merchant_not_active) |
livemode sur les objets |
false |
true |
Les données de test et de production ne se mélangent jamais : un paiement de test renvoie 404 avec votre clé de
production, et inversement, et l’argent de test ne peut pas être versé sur un vrai portefeuille.
Simuler des résultats
Section intitulée « Simuler des résultats »| Pour obtenir | Faites |
|---|---|
| un paiement réussi | POST /v1/payments/{id}/simulate {"outcome":"succeeded"} — ou cliquez sur Approuver sur la page du portefeuille de test |
| un paiement échoué | la même chose avec "failed" — ou Refuser |
| un paiement expiré | ne le payez pas ; les pages de paiement expirent au bout de 30 minutes et sont clôturées par une tâche de fond dans les ~5 minutes qui suivent |
| un versement réussi | n’importe quel numéro de bénéficiaire, par exemple +221770000001 |
| un versement échoué | un numéro de bénéficiaire qui se termine par 0000, par exemple +221770000000 — le montant réservé et les frais reviennent dans available |
insufficient_funds |
un versement supérieur à available |
simulate suit le même chemin qu’une vraie notification du prestataire (boîte de réception → machine à états → grand
livre → webhook) : ce que vous voyez en mode test est donc ce que fait le mode production. Avec une clé de production,
il renvoie 403.