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_SIGNATURECe 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
- initier un paiement avec un petit montant
- stocker le
track_id - vérifier la livraison webhook
- comparer le webhook avec
GET /payments/status/{track_id} - tester les échecs et retries
- 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éro | Opérateur | Résultat |
|---|---|---|
+237670000001 | MTN Cameroun | SUCCESS |
+237670000002 | MTN Cameroun | FAILED |
+237670000003 | MTN Cameroun | en attente, puis SUCCESS après ~5 s |
+237670000004 | MTN Cameroun | échec, solde insuffisant |
+237690000001 | Orange Cameroun | SUCCESS |
+237690000002 | Orange Cameroun | FAILED |
+237690000003 | Orange Cameroun | en attente, puis SUCCESS après ~5 s |
+237690000099 | Orange Cameroun | échec, solde insuffisant |
+2250700000001 | Côte d'Ivoire | SUCCESS |
+2250700000002 | Côte d'Ivoire | FAILED |
+2250700000003 | Côte d'Ivoire | en attente, puis SUCCESS après ~5 s |
+2250700000004 | Côte d'Ivoire | échec, solde insuffisant |
+241077000001 | Airtel Gabon | SUCCESS |
+241077000002 | Airtel Gabon | FAILED |
+241077000003 | Airtel Gabon | en attente, puis SUCCESS après ~5 s |
+241077000099 | Airtel Gabon | échec, solde insuffisant |
+241066000001 | Moov Gabon | SUCCESS |
+241066000002 | Moov Gabon | FAILED |
+241066000003 | Moov Gabon | en attente, puis SUCCESS après ~5 s |
+241066000099 | Moov Gabon | échec, solde insuffisant |
+23566000001 | Airtel Tchad | SUCCESS |
+23566000002 | Airtel Tchad | FAILED |
+23566000003 | Airtel Tchad | en attente, puis SUCCESS après ~5 s |
+23566000099 | Airtel Tchad | échec, solde insuffisant |
+23590000001 | Moov Tchad | SUCCESS |
+23590000002 | Moov Tchad | FAILED |
+23590000003 | Moov Tchad | en attente, puis SUCCESS après ~5 s |
+23590000099 | Moov Tchad | échec, solde insuffisant |
+23672000001 | Orange Centrafrique | SUCCESS |
+23672000002 | Orange Centrafrique | FAILED |
+23672000003 | Orange Centrafrique | en attente, puis SUCCESS après ~5 s |
+23672000099 | Orange Centrafrique | échec, solde insuffisant |
+242066000001 | MTN Congo | SUCCESS |
+242066000002 | MTN Congo | FAILED |
+242066000003 | MTN Congo | en attente, puis SUCCESS après ~5 s |
+242066000099 | MTN Congo | échec, solde insuffisant |
+242055000001 | Airtel Congo | SUCCESS |
+242055000002 | Airtel Congo | FAILED |
+242055000003 | Airtel Congo | en attente, puis SUCCESS après ~5 s |
+242055000099 | Airtel Congo | échec, solde insuffisant |
+240555000001 | Muni Dinero (Guinée Équatoriale) | SUCCESS |
+240555000002 | Muni Dinero (Guinée Équatoriale) | FAILED |
+240555000003 | Muni Dinero (Guinée Équatoriale) | en attente, puis SUCCESS après ~5 s |
+240555000099 | Muni Dinero (Guinée Équatoriale) | échec, solde insuffisant |
+22360000001 | Moov Mali | SUCCESS |
+22360000002 | Moov Mali | FAILED |
+22360000003 | Moov Mali | en attente, puis SUCCESS après ~5 s |
+22360000099 | Moov Mali | échec, solde insuffisant |
+22660000001 | Moov Burkina Faso | SUCCESS |
+22660000002 | Moov Burkina Faso | FAILED |
+22660000003 | Moov Burkina Faso | en attente, puis SUCCESS après ~5 s |
+22660000099 | Moov Burkina Faso | échec, solde insuffisant |
+22665000001 | Orange Burkina Faso | SUCCESS |
+22665000002 | Orange Burkina Faso | FAILED |
+22665000003 | Orange Burkina Faso | en attente, puis SUCCESS après ~5 s |
+22665000099 | Orange Burkina Faso | échec, solde insuffisant |
+22870000001 | TMoney (Togo) | SUCCESS |
+22870000002 | TMoney (Togo) | FAILED |
+22870000003 | TMoney (Togo) | en attente, puis SUCCESS après ~5 s |
+22870000099 | TMoney (Togo) | échec, solde insuffisant |
+22897000001 | Moov Togo | SUCCESS |
+22897000002 | Moov Togo | FAILED |
+22897000003 | Moov Togo | en attente, puis SUCCESS après ~5 s |
+22897000099 | Moov Togo | échec, solde insuffisant |
+2290164000001 | Moov Bénin | SUCCESS |
+2290164000002 | Moov Bénin | FAILED |
+2290164000003 | Moov Bénin | en attente, puis SUCCESS après ~5 s |
+2290164000099 | Moov 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
PROCESSINGtant 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_urlavecstatusetreference, 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
…01ou…02est réglé dès la réponse (SUCCESSouFAILED). Un numéro « en attente » répond d'abord sans issue finale, puis le paiement passe enSUCCESSenviron 5 secondes plus tard. Les webhookstransaction.*sont envoyés aux endpoints de l'environnement sandbox. CARDexige, 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_APPROVALjusqu'à 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
- obtenir un KYC approuvé
- confirmer vos plafonds dans le dashboard (page KYC)
- configurer les webhooks de production
- faire tourner les credentials si nécessaire
- démarrer avec de petits montants
How is this guide?
Last updated on