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 :

POST /v1/webhooks/sandbox
{
  "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