Zamani — Niger

Intégrer Zamani Telecom Niger (Zamani Money) avec l’API LigdiCash. Mode de validation : USSD guidé.

​

Identité

Champ	Valeur
Pays	Niger
Opérateur	Zamani Niger (Zamani Money)
operator_id	28
operator_name	ORANGE/ZAMANI NIGER
Indicatif	+227
Format du numéro	22790XXXXXXX (sans + ni espaces)
Endpoint	POST /pay/v01/straight/checkout-invoice/create
Mode de validation	USSD 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 :

Vous allez faire un retrait de 103.00 FCFA. Veuillez entrer le #146# et suivre les instructions

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

cURL

curl -X POST https://app.ligdicash.com/pay/v01/straight/checkout-invoice/create \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "commande": {
      "invoice": {
        "items": [],
        "total_amount": 5000,
        "devise": "XOF",
        "description": "Abonnement Pro — Janvier 2025",
        "customer": "22790000001",
        "customer_firstname": "Mariama",
        "customer_lastname": "Soumana",
        "customer_email": "[e-mail]",
        "external_id": "",
        "otp": ""
      },
      "store": {
        "name": "MonApp",
        "website_url": "https://monapp.com"
      },
      "actions": {
        "cancel_url": "",
        "return_url": "",
        "callback_url": "https://monapp.com/api/callback/ligdicash"
      },
      "custom_data": {
        "transaction_id": "ORD-2025-00064"
      }
    }
  }'

​

Réponse attendue

Succès (create)

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "Votre requête est en cours de traitement",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

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ètre	Valeur
Montant minimum	10 XOF
Montant maximum	—
Limite quotidienne	—

​

Pages associées

• Modes de validation — USSD guidé — détail du flux
• Créer une transaction — référence complète de l’endpoint
• Vérifier le statut — appeler confirm après le callback