Scénarios de test

Les numéros, cartes et comptes qui imposent chaque résultat.

Dans la sandbox, le résultat n'est pas aléatoire. Vous le choisissez avec le numéro de téléphone, la carte, le compte bancaire ou le portefeuille utilisé pour payer. Toutes les informations de cette page proviennent directement de la table de sandbox de la plateforme.

Mobile Money

Un numéro de test associe un préfixe d'opérateur à un suffixe de six chiffres qui détermine le résultat.

La formule

number = operator_prefix + outcome_suffix

+23767      +  000002   =  +237670000002
MTN Cameroon   failure      a payment that always fails

Les six suffixes

Suffixe	Résultat	Ce que voit votre intégration
`000000`	Réussite	`payment.succeeded` après environ 3 secondes
`000001`	Fonds insuffisants	`payment.failed`, le payeur n'avait pas de solde
`000002`	Échec	`payment.failed`, refusé par l'opérateur
`000003`	Délai dépassé	`payment.failed`, l'opérateur n'a jamais répondu
`000004`	Annulé	`payment.cancelled`, le payeur a refusé
`000009`	Réussite suivie de l'échec d'un remboursement	`payment.succeeded`, puis `refund.failed`

Les zéros supplémentaires au début sont acceptés

La partie abonné peut contenir des zéros supplémentaires avant le suffixe. Ainsi, +2376700000000 correspond également à 000000. Tout autre caractère entre le préfixe et le suffixe empêche la correspondance. Le numéro est alors rejeté, car il ne s'agit pas d'un numéro de test.

Préfixes

Seize pays et quarante-quatre opérateurs.

Pays	Opérateur	Préfixe
CamerounCameroun	MTN MoMoMTN MoMo	`+23767`
CamerounCameroun	Orange MoneyOrange Money	`+23769`
CamerounCameroun	Express UnionExpress Union	`+23768`
CamerounCameroun	YoomeeYoomee	`+23766`
Côte d'IvoireCôte d'Ivoire	MTN MoMoMTN MoMo	`+22505`
Côte d'IvoireCôte d'Ivoire	Orange MoneyOrange Money	`+22507`
Côte d'IvoireCôte d'Ivoire	MoovMoov	`+22501`
Côte d'IvoireCôte d'Ivoire	WaveWave	`+22503`
Côte d'IvoireCôte d'Ivoire	Green	`+22509`
NigeriaNigeria	MTNMTN	`+2348`
NigeriaNigeria	OrangeOrange	`+2347`
SénégalSénégal	Orange MoneyOrange Money	`+22177`
SénégalSénégal	Free	`+22176`
GhanaGhana	MTN MoMoMTN MoMo	`+23324`
GhanaGhana	Vodafone	`+23320`
GhanaGhana	AirtelAirtel	`+23326`
GhanaGhana	AirtelTigo	`+23327`
KenyaKenya	M-PesaM-Pesa	`+25470`
KenyaKenya	M-Pesa TillM-Pesa Till	`+25471`
KenyaKenya	Airtel TillAirtel Till	`+25473`
KenyaKenya	Equitel	`+25476`
KenyaKenya	T-Kash	`+25477`
TanzanieTanzanie	AirtelAirtel	`+25567`
TanzanieTanzanie	Tigo	`+25565`
TanzanieTanzanie	Vodafone	`+25574`
TanzanieTanzanie	HaloPesa	`+25562`
OugandaOuganda	MTNMTN	`+25677`
OugandaOuganda	AirtelAirtel	`+25675`
RwandaRwanda	MTNMTN	`+25078`
RwandaRwanda	AirtelAirtel	`+25073`
RD CongoRD Congo	AirtelAirtel	`+24399`
RD CongoRD Congo	OrangeOrange	`+24389`
RD CongoRD Congo	Vodacom	`+24381`
RD CongoRD Congo	Express UnionExpress Union	`+24382`
BéninBénin	MTNMTN	`+22990`
BéninBénin	MoovMoov	`+22991`
BéninBénin	Glo	`+22997`
Burkina FasoBurkina Faso	OrangeOrange	`+22670`
Burkina FasoBurkina Faso	MoovMoov	`+22671`
GabonGabon	AirtelAirtel	`+2410`
GabonGabon	Express UnionExpress Union	`+2411`
CongoCongo	Express UnionExpress Union	`+24205`
TchadTchad	Express UnionExpress Union	`+23566`
République centrafricaineRépublique centrafricaine	Express UnionExpress Union	`+23670`

Exemples complets

Scénario	MTN Cameroun	Orange Côte d'Ivoire	M-Pesa Kenya
Réussite	`+237670000000`	`+225070000000`	`+254700000000`
Fonds insuffisants	`+237670000001`	`+225070000001`	`+254700000001`
Échec	`+237670000002`	`+225070000002`	`+254700000002`
Délai dépassé	`+237670000003`	`+225070000003`	`+254700000003`
Annulé	`+237670000004`	`+225070000004`	`+254700000004`

Cartes

Utilisez n'importe quelle date d'expiration future et n'importe quel CVV. Aucun des deux n'est validé. Seul le numéro de carte détermine le résultat.

Réussite sans 3D Secure

Carte	Réseau	Résultat
`4242 4242 4242 4242`	Visa	Réussite
`5555 5555 5555 4444`	Mastercard	Réussite
`4000 0000 0000 5423`	Visa	Réussite, puis échec de chaque remboursement

Vérification 3D Secure obligatoire

Le Checkout hébergé affiche une vérification simulée. Ces cartes renvoient d'abord 202. Le statut final arrive une fois la vérification terminée.

Carte	Résultat de la vérification
`4000 0566 5566 5556`	Réussite de la vérification et du paiement
`4000 0025 0000 3155`	Réussite de la vérification et du paiement
`4000 0027 6000 3184`	Réussite de la vérification et du paiement
`4000 0025 0000 3063`	Échec de l'authentification
`4000 0025 0000 3089`	Échec de l'authentification
`4000 0025 0000 3018`	Authentification réussie, puis refus de l'émetteur
`4000 0025 0000 3026`	Authentification réussie, puis refus de l'émetteur
`4000 0025 0000 3034`	Le payeur abandonne la vérification
`4000 0025 0000 3042`	Le payeur abandonne la vérification
`4000 0025 0000 3050`	Le délai de vérification est dépassé
`4000 0025 0000 3097`	Le délai de vérification est dépassé

Échec sans 3D Secure

Carte	Résultat
`4000 0000 0000 9995`	Fonds insuffisants
`4000 0000 0000 0002`	Refus
`4000 0000 0000 9987`	Refus
`4000 0000 0000 9979`	Refus
`4000 0000 0000 0069`	Refus
`4000 0000 0000 0127`	Refus
`4000 0000 0000 0119`	Refus
`4000 0000 0000 0341`	Refus
`4000 0000 0000 6975`	Refus
`4242 4242 4242 4241`	Refus

Un seul motif de refus, pas dix

Seule la carte …9995 possède un motif distinct. Les neuf autres produisent le même refus générique. Utilisez celle que vous souhaitez pour tester un parcours d'échec. Une carte absente de cette page est refusée, car elle ne correspond pas à une carte de test.

Comptes bancaires

Tout numéro de compte ou IBAN d'au moins quatre caractères est accepté. Les deux derniers chiffres déterminent le résultat.

Se termine par	Résultat
`00`	Réussite
`01`	Fonds insuffisants
`02`	Échec
`03`	Délai dépassé
`04`	Annulé

Toute autre valeur réussit. Un compte qui se termine par 47 fonctionne donc simplement.

Cryptomonnaies

Le canal des cryptomonnaies est désactivé dans la sandbox, sauf s'il a été activé pour votre compte. Une fois actif, le suffixe de l'adresse du portefeuille détermine le résultat.

Fin de l'adresse	Résultat
`_success`	Réussite
`_insufficient`	Fonds insuffisants
`_failure`	Échec
`_timeout`	Délai dépassé
`_canceled`	Annulé

L'adresse de dépôt renvoyée par l'API est générée de manière déterministe à partir du paiement, du canal et du scénario. Deux exécutions du même test produisent donc la même adresse. Elle expire après 30 minutes.

Remboursements

Le résultat d'un remboursement dépend du paiement d'origine, pas de l'appel de remboursement.

Moyen utilisé pour le paiement	Résultat du remboursement
`4000 0000 0000 5423`	Échec systématique
Un numéro qui se termine par `000009`	Échec systématique
Un numéro qui se termine par `000001`, `000002`, `000003` ou `000004`	Échec
Un numéro qui se termine par `000000`	Réussite
Toute autre carte, un compte bancaire ou un portefeuille de cryptomonnaie	Réussite

Transferts

Un payout utilise les informations du bénéficiaire et les mêmes suffixes s'appliquent. Un bénéficiaire Mobile Money doit posséder un numéro de test reconnu.

L'erreur 422 renvoyée dans le cas contraire

{

"message": "The given data was invalid.",

"errors": {

"beneficiary": [

"Invalid sandbox test number. Use a recognised Mobile Money test number, e.g. +237670000000 (success), +237670000001 (insufficient funds), +237670000002 (failure), +237670000003 (timeout), +237670000004 (canceled)."

]

}

Un transfert débite votre solde de sandbox. Commencez donc par réussir un paiement. Dans le cas contraire, le payout échoue pour cause de fonds insuffisants, exactement comme en mode live.

Pages associées