Integration

Sandbox

Un environnement complet et deterministe pour reproduire tous les parcours, sans jamais toucher un reseau reel.

Connexions simulees

sandbox_tmoney, sandbox_flooz et sandbox_card sont des connexions entierement simulees. Elles ne communiquent avec aucun operateur, aucune banque et aucun reseau carte, et ne doivent jamais etre presentees comme des integrations reelles. Toute transaction sandbox est marquee "livemode": false dans l’API, dans les webhooks et dans l’interface.

Activer le sandbox

Utilisez simplement une cle sk_test_…. L’environnement est deduit de la cle : aucun parametre supplementaire n’est necessaire, et il est impossible de melanger des donnees sandbox et production.

Numeros mobile money de test

Le suffixe du numero determine l’issue de la transaction.

Numero	Scenario	Comportement
+228 90 00 0000	`success`	Confirme apres ~6 secondes.
+228 90 00 0001	`failed`	Echec — insufficient_funds.
+228 90 00 0002	`pending`	Reste en attente jusqu’a expiration.
+228 90 00 0003	`expired`	Expire apres ~45 secondes.
+228 90 00 0004	`declined`	Le client refuse l’autorisation.
+228 90 00 0005	`processing_error`	Erreur reseau apres passage en processing.

Cartes de test

Numero	Scenario	Comportement
4242 4242 4242 4242	`instant_success`	Autorisation acceptee.
4000 0000 0000 0002	`declined`	Carte refusee par l’emetteur.
4000 0000 0000 0119	`processing_error`	Erreur de traitement.
4000 0000 0000 9995	`failed`	Solde insuffisant.

Aucun numero de carte reel n’est accepte : seuls ces PAN de test sont reconnus.

Forcer un scenario

Vous pouvez imposer un scenario independamment du numero, via les metadonnees de la requete :

{
  "amount": 10000,
  "currency": "XOF",
  "country": "TG",
  "payment_method": "mobile_money",
  "network": "tmoney",
  "customer": { "phone": "+22891234567" },
  "metadata": { "sandbox_scenario": "failed" }
}

Endpoints reserves au sandbox

POST/v1/sandbox/simulateForcer l’issue d’une transactioncle secrete

POST/v1/sandbox/fundCrediter le solde de testcle secrete

GET/v1/sandbox/scenariosLister scenarios et numeros de testcle publique ou secrete

Ces endpoints renvoient 403 avec une cle de production : ils ne peuvent pas etre appeles en live.

Tester les payouts et remboursements

Creditez votre solde de test via POST /v1/sandbox/fund ou depuis le dashboard (Solde & Ledger).
Le credit produit de vraies ecritures au ledger sandbox, avec une contrepartie dediee : les invariants comptables restent verifies.
Les payouts reservent puis, en cas d’echec, restituent les fonds exactement comme en production.

Passer en production

L’architecture est concue pour que le passage en production ne change rien a votre code : seule la cle API change. Cote WanePay, une connexion reelle remplacera l’adaptateur simule — le Payment Engine, le routing, le ledger et l’API publique restent identiques.