Sandbox
Environnement de test isolé, sans argent réel : le simulateur AIFI PAY, ou la page de test d’Orange Money.
Ce que permet le Sandbox
- Création de paiements via API et dashboard
- Scénarios simulés : SUCCESS, FAILED, PENDING, TIMEOUT, EXPIRED
- Page de test d’Orange Money, pour vérifier la redirection
- Liens de paiement payables
- Webhook entrant de simulation
- Remboursements via le simulateur
Le simulateur et sandboxScenario
Sur POST /v1/payments (et équivalents), le simulateur est utilisé par défaut en Sandbox. Choisissez le résultat avec sandboxScenario :
{
"amount": 25000,
"provider": "SANDBOX_SIMULATOR",
"sandboxScenario": "SUCCESS"
}SUCCESS: le paiement réussit aussitôt.FAILED,EXPIRED: le paiement échoue ou expire aussitôt.PENDING,TIMEOUT: le paiement reste en attente, jusqu’à ce que vous donniez le résultat (ci-dessous).
Donner le résultat d’un paiement en attente
Créez le paiement avec "sandboxScenario": "PENDING", puis envoyez le résultat au webhook Sandbox, avec le providerReference reçu dans la réponse :
{
"providerReference": "sim_…",
"status": "SUCCEEDED",
"eventId": "evt_test_001"
}Tester la page Orange Money
Avec une clé sk_test_…, envoyez "provider": "ORANGE_MONEY" et successUrl : l’API renvoie dans paymentUrl la page de test d’Orange, à ouvrir comme en Production (voir le parcours complet). Vérifiez d’abord avec GET /v1/payment-methods qu’Orange Money est disponible pour votre clé.
Pour terminer un paiement sur cette page, il faut un compte de test et un code Orange : demandez-les au support AIFI PAY au moment de votre essai.
Clés
Utilisez une clé sk_test_… créée pour l’environnement SANDBOX de votre boutique.
Suite : Webhooks Sandbox · Paiements