Numéros de test

En mode test, aucun opérateur n'est contacté. Le résultat dépend des 4 derniers chiffres du numéro, ou d'un mot-clé dans reference. Utilisez une clé API test.

Changez reference à chaque essai. La même référence rejoue la transaction déjà créée (idempotence).

Règle

La règle s'applique au Collect direct (hors OTP) et au Payout. Le + éventuel est ignoré.

Fin du numéro	Mot-clé dans `reference`	Collect	Payout
autre, ou `0000`	aucun	`completed`	`COMPLETED`
`0001`	`FAIL`	`failed`	`FAILED`
`0002`	`PENDING`	`pending`	`PENDING`
`0003`	`CANCEL`	`cancelled`	`CANCELLED`

Un seul signal suffit. FAIL est évalué avant PENDING, puis CANCEL.

Numéros à copier

Longueur attendue : Bénin et Côte d'Ivoire 13 chiffres, Togo 11. Indicatif inclus, sans +.

Pays	Succès	Échec	Attente	Annulé
Bénin `BJ`	`2290166000000`	`2290166000001`	`2290166000002`	`2290166000003`
Côte d'Ivoire `CI`	`2250100000000`	`2250100000001`	`2250100000002`	`2250100000003`
Togo `TG`	`22890000000`	`22890000001`	`22890000002`	`22890000003`

Collect direct, succès MTN Bénin

curl -X POST 'https://api.fluxxpay.me/api/v1/collect/payments' \
  -H 'Authorization: Bearer <clé_api_test>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: test-success-1' \
  -d '{
    "reference": "test-success-1",
    "amount": 100,
    "currency": "XOF",
    "country": "BJ",
    "mode": "direct",
    "operator": "mtn",
    "customer": { "phone": "2290166000000" }
  }'

Pour un échec, gardez le même corps et remplacez le numéro par 2290166000001 (et la référence).

Essayer dans le playground Collect

OTP

Les opérateurs OTP n'utilisent pas les 4 derniers chiffres à la création.

Name
Coris Bénin (confirmation)
Description
operator: coris répond awaiting_otp. Confirmez avec POST /collect/payments/{reference}/confirm. 123456 → completed. 000000 → failed. 111111 → reste en attente.
Name
OTP à la création
Description
Lorsque la matrice indique « À la création », envoyez otp dans le POST (4 à 8 chiffres). 000000 est refusé. Tout autre code sandbox est accepté.

Coris n'est pas disponible en Payout. Voir la matrice des corridors.

Checkout hébergé

mode: hosted répond awaiting_payment et une checkout_url. En test, POST /collect/payments/{reference}/pay simule le paiement du client.

Référence

À la place du numéro, placez le mot-clé dans reference : order-FAIL, order-PENDING, order-CANCEL. La casse n'a pas d'importance.

Le webhook part comme en production, avec "environment": "test". Vérifiez la signature avant d'agir. Un webhook test ne livre pas une commande réelle.

Mode test et passage en production Webhooks Corridors