Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://developers.ligdicash.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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 : 
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 -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": "mariama@exemple.com",
        "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

{
  "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ètreValeur
Montant minimum10 XOF
Montant maximum—
Limite quotidienne—

​
Pages associées