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
OperatorMoov Africa Côte d’Ivoire (Moov Money)
operator_id14
operator_nameMOOV CI
Country code+225
Number format225XXXXXXXXXX (no + or spaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Validation modeUSSD Push (fallback: Guided USSD)

​
Validation modes

Moov Côte d’Ivoire uses two modes depending on network availability at the moment of the transaction. You submit the same request in both cases — the operator decides on the mode on the network side. Primary mode — USSD Push: after your request, the operator pushes a USSD prompt directly to the customer’s phone. The customer validates with their Moov Money PIN. No extra input on the merchant side. Fallback mode — Guided USSD: if the push does not go through, the operator sends an SMS containing the transaction reference and the USSD code to dial. The customer dials the USSD to validate. Example SMS received in fallback mode: 
Vous avez une transaction 0000000433 - LIGDICASH_CI en attente.
Faites *155*15# pour payer.
Your UX must anticipate both cases. Show a message that covers both: the customer will receive either a USSD push to validate directly, or an SMS with the instructions to follow.
1

Collect the customer's number

Your form only collects the Moov phone number. No OTP to collect.
2

Submit the request

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

Show a waiting message

After submission, display a message like:
“Validate the payment on your phone. You will receive a USSD validation prompt, or an SMS with the instructions to follow.”
Keep this 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": "2250101000000",
        "customer_firstname": "Adama",
        "customer_lastname": "Koffi",
        "customer_email": "adama@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-00055"
      }
    }
  }'

​
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 amount100 XOF
Maximum amount—
Daily limit—