Guides
Mode test
Validez votre intégration en sécurité avant d’activer le trafic de production.
Mode test
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
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
Exemple
curl -X POST "{{BASE_URL}}/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": "677001122",
"external_id": "test_payment_001"
}'Passage en live
- obtenir un KYC approuvé
- confirmer les plafonds via
GET /kyc/limits - configurer les webhooks de production
- faire tourner les credentials si nécessaire
- démarrer avec de petits montants
How is this guide?