Zamani — Niger

Integrate Zamani Telecom Niger (Zamani Money) with the LigdiCash API. Validation mode: Guided USSD.

Identity

Field	Value
Country	Niger
Operator	Zamani Niger (Zamani Money)
operator_id	28
operator_name	ORANGE/ZAMANI NIGER
Country code	+227
Number format	22790XXXXXXX (no + or spaces)
Endpoint	POST /pay/v01/straight/checkout-invoice/create
Validation mode	Guided 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.

Recommended UX

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

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": "[e-mail]",
        "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

Success (create)

{
  "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

Parameter	Value
Minimum amount	10 XOF
Maximum amount	—
Daily limit	—

Related pages

• Validation modes — Guided USSD — flow details
• Create a transaction — full endpoint reference
• Verify the status — call confirm after the callback