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
CountryCôte d’Ivoire
OperatorMTN Mobile Money Côte d’Ivoire
operator_id15
operator_nameMTN CI
Country code+225
Number format225XXXXXXXXXX (no + or spaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Validation modeGuided USSD

​
Validation mode: Guided USSD

After your request, MTN sends an SMS to the customer with the transaction reference and the USSD code to dial to approve the payment. The customer dials this code on their phone — they reach a USSD menu asking them to confirm with their MoMo PIN. No extra input on the merchant side: the callback remains the source of truth. Example SMS received by the customer: 
Vous avez reçu une demande de débit avec la référence 1692100357.
Tapez *133# puis choisissez l'option retrait pour approuver.
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 MTN 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 MoMo 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": "2250505000000",
        "customer_firstname": "Aïssata",
        "customer_lastname": "Bamba",
        "customer_email": "aissata@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-00056"
      }
    }
  }'

​
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—