Passer au contenu principal

Identité

ChampValeur
PaysNiger
OpérateurZamani Niger (Zamani Money)
operator_id28
operator_nameORANGE/ZAMANI NIGER
Indicatif+227
Format du numéro22790XXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationUSSD guidé

Mode de validation : USSD guidé

Après votre requête, Zamani envoie un SMS au client contenant le montant du paiement et le code USSD à composer pour approuver. Le client compose ce code sur son téléphone — il accède à un menu USSD qui lui demande de confirmer avec son code PIN Zamani Money. Aucune saisie supplémentaire côté marchand : le callback reste la source de vérité. Exemple de SMS reçu par le client :
Le SMS arrive en quelques secondes mais le client peut prendre plusieurs minutes pour le lire et composer le USSD. Conservez l’état d’attente jusqu’à la réception du callback.

UX recommandée

1

Collecter le numéro du client

Votre formulaire recueille uniquement le numéro de téléphone Zamani. Aucun OTP à collecter à ce stade.
2

Soumettre la requête

Requête avec le numéro dans customer et otp: "".
3

Afficher un message d'attente

Après soumission, affichez :
« Vous allez recevoir un SMS sur votre téléphone avec les instructions pour valider le paiement. Composez le code USSD indiqué et confirmez avec votre code PIN Zamani Money. »
Maintenez l’état d’attente jusqu’à la réception du callback.

Exemple de requête

Réponse attendue

Stockez le token immédiatement après la création. Utilisez-le pour appeler confirm à la réception du callback — ne vous fiez pas au token présent dans le payload du callback.

Limites

ParamètreValeur
Montant minimum10 XOF
Montant maximum
Limite quotidienne

Pages associées