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
CountryBurkina Faso
OperatorMoov Africa Burkina
operator_id12
operator_nameMOOV AFRICA BURKINA
Country code+226
Number format226XXXXXXXXX (no + or spaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Validation modeUSSD Push (fallback: Guided USSD)

​
Validation modes

Moov Africa Burkina Faso 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 PIN. No extra input on the merchant side. Fallback mode — Guided USSD: if the push does not go through, the operator sends an SMS with the instructions and the USSD code to dial. The customer dials the USSD to validate.
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": "22660000000",
        "customer_firstname": "Aminata",
        "customer_lastname": "Sawadogo",
        "customer_email": "aminata@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-00043"
      }
    }
  }'

​
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 amount2,000,000 XOF
Daily limit—