Logo GenukaGenuka Pay
Guides

Mode test

Validez votre intégration en sécurité avant d’activer le trafic de production.

Le mode test sert à valider les flux backend, l’idempotence, la réception webhook et la réconciliation avant du trafic live.

Headers requis

X-Public-Key: YOUR_PUBLIC_KEY
X-Timestamp: UNIX_TIMESTAMP
X-Signature: HMAC_SHA256_SIGNATURE

Ce qu’il faut valider

  • initiation de paiement
  • initiation de payout
  • réception des webhooks
  • gestion des retries
  • réconciliation via track_id
  • mapping interne via external_id
  • le retour du payeur sur votre return_url / cancel_url, pour les opérateurs à redirection

Checklist suggérée

  1. initier un paiement avec un petit montant
  2. stocker le track_id
  3. vérifier la livraison webhook
  4. comparer le webhook avec GET /payments/status/{track_id}
  5. tester les échecs et retries
  6. confirmer votre état KYC avant le live

Numéros de test

En sandbox, l'issue du paiement est déterminée par le numéro du payeur. Aucun vrai débit, aucune notification sur un vrai téléphone.

NuméroOpérateurRésultat
+237670000001MTN CamerounSUCCESS
+237670000002MTN CamerounFAILED
+237670000003MTN Camerounen attente, puis SUCCESS après ~5 s
+237670000004MTN Camerounéchec, solde insuffisant
+237690000001Orange CamerounSUCCESS
+237690000002Orange CamerounFAILED
+237690000003Orange Camerounen attente, puis SUCCESS après ~5 s
+237690000099Orange Camerounéchec, solde insuffisant
+2250700000001Côte d'IvoireSUCCESS
+2250700000002Côte d'IvoireFAILED
+2250700000003Côte d'Ivoireen attente, puis SUCCESS après ~5 s
+2250700000004Côte d'Ivoireéchec, solde insuffisant
+241077000001Airtel GabonSUCCESS
+241077000002Airtel GabonFAILED
+241077000003Airtel Gabonen attente, puis SUCCESS après ~5 s
+241077000099Airtel Gabonéchec, solde insuffisant
+241066000001Moov GabonSUCCESS
+241066000002Moov GabonFAILED
+241066000003Moov Gabonen attente, puis SUCCESS après ~5 s
+241066000099Moov Gabonéchec, solde insuffisant
+23566000001Airtel TchadSUCCESS
+23566000002Airtel TchadFAILED
+23566000003Airtel Tchaden attente, puis SUCCESS après ~5 s
+23566000099Airtel Tchadéchec, solde insuffisant
+23590000001Moov TchadSUCCESS
+23590000002Moov TchadFAILED
+23590000003Moov Tchaden attente, puis SUCCESS après ~5 s
+23590000099Moov Tchadéchec, solde insuffisant
+23672000001Orange CentrafriqueSUCCESS
+23672000002Orange CentrafriqueFAILED
+23672000003Orange Centrafriqueen attente, puis SUCCESS après ~5 s
+23672000099Orange Centrafriqueéchec, solde insuffisant
+242066000001MTN CongoSUCCESS
+242066000002MTN CongoFAILED
+242066000003MTN Congoen attente, puis SUCCESS après ~5 s
+242066000099MTN Congoéchec, solde insuffisant
+242055000001Airtel CongoSUCCESS
+242055000002Airtel CongoFAILED
+242055000003Airtel Congoen attente, puis SUCCESS après ~5 s
+242055000099Airtel Congoéchec, solde insuffisant
+240555000001Muni Dinero (Guinée Équatoriale)SUCCESS
+240555000002Muni Dinero (Guinée Équatoriale)FAILED
+240555000003Muni Dinero (Guinée Équatoriale)en attente, puis SUCCESS après ~5 s
+240555000099Muni Dinero (Guinée Équatoriale)échec, solde insuffisant
+22360000001Moov MaliSUCCESS
+22360000002Moov MaliFAILED
+22360000003Moov Malien attente, puis SUCCESS après ~5 s
+22360000099Moov Maliéchec, solde insuffisant
+22660000001Moov Burkina FasoSUCCESS
+22660000002Moov Burkina FasoFAILED
+22660000003Moov Burkina Fasoen attente, puis SUCCESS après ~5 s
+22660000099Moov Burkina Fasoéchec, solde insuffisant
+22665000001Orange Burkina FasoSUCCESS
+22665000002Orange Burkina FasoFAILED
+22665000003Orange Burkina Fasoen attente, puis SUCCESS après ~5 s
+22665000099Orange Burkina Fasoéchec, solde insuffisant
+22870000001TMoney (Togo)SUCCESS
+22870000002TMoney (Togo)FAILED
+22870000003TMoney (Togo)en attente, puis SUCCESS après ~5 s
+22870000099TMoney (Togo)échec, solde insuffisant
+22897000001Moov TogoSUCCESS
+22897000002Moov TogoFAILED
+22897000003Moov Togoen attente, puis SUCCESS après ~5 s
+22897000099Moov Togoéchec, solde insuffisant
+2290164000001Moov BéninSUCCESS
+2290164000002Moov BéninFAILED
+2290164000003Moov Béninen attente, puis SUCCESS après ~5 s
+2290164000099Moov Béninéchec, solde insuffisant

Le Gabon et le Congo exigent le 0 de tronc domestique dans ce format (+241077..., pas +24177...) : c'est le format que Peex lui-même valide. Le Bénin utilise sa numérotation à 10 chiffres en vigueur depuis le 30 novembre 2024 (préfixe 01 devant l'ancien numéro à 8 chiffres).

Tout autre numéro est refusé en sandbox : c'est voulu, cela évite de croire qu'un flux fonctionne alors qu'il n'a rien simulé.

Opérateurs à redirection : la page de test

Carte bancaire, Orange, Wave et Djamo envoient le payeur sur une page. En sandbox, redirect_url pointe sur une page de test Genuka Pay qui tient le rôle de l'opérateur : deux boutons, Payer et Annuler.

Ce que cela change :

  • Le paiement ne se règle pas tout seul. Il reste en PROCESSING tant que personne n'a cliqué — comme un vrai paiement Wave, qui attend le payeur.
  • Payer applique le résultat demandé par votre numéro de test : +2250700000004 échoue toujours en solde insuffisant, il échoue simplement là où un vrai paiement échouerait.
  • Annuler fait échouer le paiement avec le code PAYMENT_DECLINED.
  • Dans les deux cas, vous êtes renvoyé sur votre return_url / cancel_url avec status et reference, par exactement le même code qu'en production.

C'est le seul moyen de tester votre URL de retour

Envoyez toujours return_url quand vous testez un opérateur à redirection. Sans elle, la page de test vous renvoie sur la page d'accueil de Genuka Pay — ce qui est précisément ce que vivrait votre client en live.

Ce qui se comporte comme en live

  • Les clés sandbox commencent par pk_test_ / sk_test_ ; il n'y a ni header ni URL à changer.
  • Un paiement mobile money sur un numéro …01 ou …02 est réglé dès la réponse (SUCCESS ou FAILED). Un numéro « en attente » répond d'abord sans issue finale, puis le paiement passe en SUCCESS environ 5 secondes plus tard. Les webhooks transaction.* sont envoyés aux endpoints de l'environnement sandbox.
  • CARD exige, comme en live, que le paiement par carte soit activé sur votre compte.
  • Les payouts suivent le même circuit qu'en live : ils restent en AWAITING_APPROVAL jusqu'à leur validation.
  • Les plafonds KYC ne s'appliquent pas en sandbox, et aucun reçu WhatsApp n'est envoyé.

Exemple

curl -X POST "https://api-pay.genuka.com/api/v1/payments" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "currency": "XAF",
    "payer_phone": "+237670000001",
    "external_id": "test_payment_001"
  }'

Passage en live

  1. obtenir un KYC approuvé
  2. confirmer vos plafonds dans le dashboard (page KYC)
  3. configurer les webhooks de production
  4. faire tourner les credentials si nécessaire
  5. démarrer avec de petits montants

How is this guide?

Last updated on