Sandbox Mobile Money

Comportement PROCESSING, polling /status et bonnes pratiques en environnement test.

Flux asynchrone

Après POST /checkout/pay/:sessionId/complete, la réponse peut être status PROCESSING avec nextAction POLL.

Interrogez GET /checkout/pay/:sessionId/status toutes les pollAfterMs millisecondes (souvent ~4 200 ms) jusqu'à SUCCEEDED, FAILED ou EXPIRED.

Expiration de session

Une session ouverte expire environ 30 minutes après création (expiresAt). Au-delà, /status renvoie EXPIRED et la session n'est plus payable.

Un paiement Mobile Money en PROCESSING depuis plus de 10 minutes sans confirmation provider passe en FAILED (failureCode PAYMENT_NOT_CONFIRMED).

Bonnes pratiques

  • Une session active par numéro de téléphone : évitez les rafales de /complete sur le même MSISDN.
  • Réutilisez le sessionToken retourné à la création de session (header X-Checkout-Session-Token) en production sur /complete et /select-method.
  • Les routes publiques /complete et /select-method sont limitées (5 requêtes / 15 min par session, numéro et IP).

Numéros de test

IZZIPAY ne publie pas encore de fiche de numéros sandbox garantissant succès ou échec.