Skip to main content

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.

​
Identity

FieldValue
CountryNiger
OperatorZamani Niger (Zamani Money)
operator_id28
operator_nameORANGE/ZAMANI NIGER
Country code+227
Number format22790XXXXXXX (no + or spaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Validation modeGuided USSD

​
Validation mode: Guided USSD

After your request, Zamani sends an SMS to the customer with the payment amount and the USSD code to dial to approve. The customer dials this code on their phone — they reach a USSD menu asking them to confirm with their Zamani Money PIN. No extra input on the merchant side: the callback remains the source of truth. Example SMS received by the customer: 
Vous allez faire un retrait de 103.00 FCFA. Veuillez entrer le #146# et suivre les instructions
The SMS arrives within seconds, but the customer may take several minutes to read it and dial the USSD. Keep the waiting state until the callback arrives.
1

Collect the customer's number

Your form only collects the Zamani phone number. No OTP to collect at this stage.
2

Submit the request

Request with the number in customer and otp: "".
3

Show a waiting message

After submission, display:
“You will receive an SMS on your phone with the instructions to validate the payment. Dial the USSD code shown and confirm with your Zamani Money PIN.”
Keep the waiting state until the callback arrives.

​
Request example

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": "Pro Subscription — January 2025",
        "customer": "22790000001",
        "customer_firstname": "Mariama",
        "customer_lastname": "Soumana",
        "customer_email": "mariama@example.com",
        "external_id": "",
        "otp": ""
      },
      "store": {
        "name": "MyApp",
        "website_url": "https://myapp.com"
      },
      "actions": {
        "cancel_url": "",
        "return_url": "",
        "callback_url": "https://myapp.com/api/callback/ligdicash"
      },
      "custom_data": {
        "transaction_id": "ORD-2025-00064"
      }
    }
  }'

​
Expected response

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "Votre requête est en cours de traitement",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}
Store the token immediately after creation. Use it to call confirm when the callback is received — never rely on the token in the callback payload.

​
Limits

ParameterValue
Minimum amount10 XOF
Maximum amount—
Daily limit—