Documentation/Tester
openapi.jsonOuvrir mon espace

Tester

Les clés sk_test_ parlent à un simulateur : aucun argent ne bouge, aucun téléphone ne sonne. Les deux derniers chiffres du numéro choisissent ce qui arrive.

Le numéro choisit le scénario

En mode test, les deux derniers chiffres du numéro du payeur décident de ce qui arrive, que la demande parte de la page de paiement, du widget ou du paiement direct. Les mêmes fins valent pour les retraits.

FinCe qui se passeCe que l’API rend
…00Réussi après 5 s, comme toute autre finsucceeded
…01Solde insuffisant après 3 sfailed · insufficient_funds
…02Le payeur refuse après 3 sfailed · payer_declined
…03Personne ne valide : expirée après 90 sexpired · timeout
…04Statut inconnu, puis réussi après 120 spending, puis succeeded
…05Processeur injoignable, tout de suitefailed · operator_unavailable
…06Réussi après 5 s, sans notification : Payiz le trouve en relisantsucceeded

La raison d’un échec arrive dans failure_code, sur la demande comme dans le webhook payment.attempt_failed.

Un numéro par opérateur

Un numéro d’essai doit tout de même se lire : pays ouvert, préfixe de l’opérateur, bonne longueur. Voici un numéro valide par opérateur ouvert, tiré des référentiels ; changez les deux derniers chiffres pour changer de scénario.

PaysOpérateurNuméro d’essaioperator
BéninMoov+229 01 94 00 00 00déduit du numéro
BéninMTN+229 01 96 00 00 00déduit du numéro
Burkina FasoMoovTout numéro du paysmoov, à préciser
CamerounMTNTout numéro du paysmtn_momo, à préciser
CamerounOrangeTout numéro du paysorange, à préciser
CongoAirtelTout numéro du paysairtel, à préciser
CongoMTNTout numéro du paysmtn_momo, à préciser
Côte d’IvoireMoovTout numéro du paysmoov, à préciser
Côte d’IvoireMTNTout numéro du paysmtn_momo, à préciser
Côte d’IvoireOrangeTout numéro du paysorange, à préciser
GabonAirtelTout numéro du paysairtel, à préciser
GhanaATTout numéro du paysairteltigo, à préciser
GhanaMTNTout numéro du paysmtn_momo, à préciser
GhanaTelecelTout numéro du paysvodafone, à préciser
KenyaSafaricomTout numéro du paysmpesa, à préciser
MalawiAirtelTout numéro du paysairtel, à préciser
MalawiTNMTout numéro du paystnm, à préciser
MozambiqueVodacomTout numéro du paysvodacom, à préciser
OugandaMTNTout numéro du paysmtn_momo, à préciser
République démocratique du CongoAirtelTout numéro du paysairtel, à préciser
République démocratique du CongoOrangeTout numéro du paysorange, à préciser
République démocratique du CongoVodacomTout numéro du paysvodacom_mpesa, à préciser
RwandaAirtelTout numéro du paysairtel, à préciser
RwandaMTNTout numéro du paysmtn_momo, à préciser
SénégalFreeTout numéro du paysfree, à préciser
SénégalOrangeTout numéro du paysorange, à préciser
Sierra LeoneOrangeTout numéro du paysorange, à préciser
TanzanieAirtelTout numéro du paysairtel, à préciser
TanzanieHalotelTout numéro du payshalotel, à préciser
TanzanieTigoTout numéro du paystigo, à préciser
TanzanieVodacomTout numéro du paysvodacom, à préciser
ZambieAirtelTout numéro du paysairtel_oapi, à préciser
ZambieMTNTout numéro du paysmtn_momo, à préciser
ZambieZamtelTout numéro du payszamtel, à préciser
Là où Payiz ne connaît pas les préfixes, il ne peut pas deviner l’opérateur : la page de paiement le fait choisir, et en direct vous le précisez dans operator.

Ce qui ne bouge pas en test

  • Aucun argent : les soldes de test vivent dans un grand livre à part.
  • Les frais se calculent comme en réel.
  • Les webhooks partent, marqués de leur mode, vers vos destinations de test : c’est le but.
  • Aucun e-mail à vos clients, sauf ceux que vous envoyez vous-même depuis l’espace.
  • Les plafonds du palier ne s’appliquent pas.
  • Le paiement direct est ouvert à tous les espaces.

Prêt ? Passer au réel dit ce que la vérification ouvre, et ce qu’il faut tenir avant le premier paiement réel.

© 2026 PayizUne question ? L’aide est dans le rond, en bas à droite.

Les clés sk_test_ parlent à un simulateur : aucun argent ne bouge, aucun téléphone ne sonne. Les deux derniers chiffres du numéro choisissent ce qui arrive.

Le numéro choisit le scénario

En mode test, les deux derniers chiffres du numéro du payeur décident de ce qui arrive, que la demande parte de la page de paiement, du widget ou du paiement direct. Les mêmes fins valent pour les retraits.

FinCe qui se passeCe que l’API rend
…00Réussi après 5 s, comme toute autre finsucceeded
…01Solde insuffisant après 3 sfailed · insufficient_funds
…02Le payeur refuse après 3 sfailed · payer_declined
…03Personne ne valide : expirée après 90 sexpired · timeout
…04Statut inconnu, puis réussi après 120 spending, puis succeeded
…05Processeur injoignable, tout de suitefailed · operator_unavailable
…06Réussi après 5 s, sans notification : Payiz le trouve en relisantsucceeded

La raison d’un échec arrive dans failure_code, sur la demande comme dans le webhook payment.attempt_failed.

Un numéro par opérateur

Un numéro d’essai doit tout de même se lire : pays ouvert, préfixe de l’opérateur, bonne longueur. Voici un numéro valide par opérateur ouvert, tiré des référentiels ; changez les deux derniers chiffres pour changer de scénario.

PaysOpérateurNuméro d’essaioperator
BéninMoov+229 01 94 00 00 00déduit du numéro
BéninMTN+229 01 96 00 00 00déduit du numéro
Burkina FasoMoovTout numéro du paysmoov, à préciser
CamerounMTNTout numéro du paysmtn_momo, à préciser
CamerounOrangeTout numéro du paysorange, à préciser
CongoAirtelTout numéro du paysairtel, à préciser
CongoMTNTout numéro du paysmtn_momo, à préciser
Côte d’IvoireMoovTout numéro du paysmoov, à préciser
Côte d’IvoireMTNTout numéro du paysmtn_momo, à préciser
Côte d’IvoireOrangeTout numéro du paysorange, à préciser
GabonAirtelTout numéro du paysairtel, à préciser
GhanaATTout numéro du paysairteltigo, à préciser
GhanaMTNTout numéro du paysmtn_momo, à préciser
GhanaTelecelTout numéro du paysvodafone, à préciser
KenyaSafaricomTout numéro du paysmpesa, à préciser
MalawiAirtelTout numéro du paysairtel, à préciser
MalawiTNMTout numéro du paystnm, à préciser
MozambiqueVodacomTout numéro du paysvodacom, à préciser
OugandaMTNTout numéro du paysmtn_momo, à préciser
République démocratique du CongoAirtelTout numéro du paysairtel, à préciser
République démocratique du CongoOrangeTout numéro du paysorange, à préciser
République démocratique du CongoVodacomTout numéro du paysvodacom_mpesa, à préciser
RwandaAirtelTout numéro du paysairtel, à préciser
RwandaMTNTout numéro du paysmtn_momo, à préciser
SénégalFreeTout numéro du paysfree, à préciser
SénégalOrangeTout numéro du paysorange, à préciser
Sierra LeoneOrangeTout numéro du paysorange, à préciser
TanzanieAirtelTout numéro du paysairtel, à préciser
TanzanieHalotelTout numéro du payshalotel, à préciser
TanzanieTigoTout numéro du paystigo, à préciser
TanzanieVodacomTout numéro du paysvodacom, à préciser
ZambieAirtelTout numéro du paysairtel_oapi, à préciser
ZambieMTNTout numéro du paysmtn_momo, à préciser
ZambieZamtelTout numéro du payszamtel, à préciser
Là où Payiz ne connaît pas les préfixes, il ne peut pas deviner l’opérateur : la page de paiement le fait choisir, et en direct vous le précisez dans operator.

Ce qui ne bouge pas en test

  • Aucun argent : les soldes de test vivent dans un grand livre à part.
  • Les frais se calculent comme en réel.
  • Les webhooks partent, marqués de leur mode, vers vos destinations de test : c’est le but.
  • Aucun e-mail à vos clients, sauf ceux que vous envoyez vous-même depuis l’espace.
  • Les plafonds du palier ne s’appliquent pas.
  • Le paiement direct est ouvert à tous les espaces.

Prêt ? Passer au réel dit ce que la vérification ouvre, et ce qu’il faut tenir avant le premier paiement réel.