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
OperatorOrange Burkina
operator_id11
operator_nameORANGE BURKINA
Country code+226
Number format22670XXXXXXX (no + or spaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Validation modeUSSD OTP

Validation mode: USSD OTP

The customer generates their OTP by dialing the USSD code *144*4*6# on their phone before sharing it with you. You submit a single request with the number and the OTP. The operator validates the transaction on the network side — this processing can take from a few seconds to several minutes. The callback is the source of truth.
Display the USSD code to dial (*144*4*6#) with clear instructions before the customer fills out the form. The generated OTP has a short validity period — encourage the customer to enter it immediately.
1

Show the USSD instructions

Before any form, tell the customer to dial *144*4*6# on their Orange phone. A one-time OTP code appears on their screen.
2

Collect the number and the OTP

Your form collects, at the same time:
  • the Orange phone number in the format 22670XXXXXXX
  • the OTP code received via USSD
3

Submit the request

A single API request with customer and otp filled.
4

Show a waiting indicator

Operator validation can take from a few seconds to several minutes. Show a waiting state and wait for the callback.

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": "22670000000",
        "customer_firstname": "Amadou",
        "customer_lastname": "Diallo",
        "customer_email": "amadou@example.com",
        "external_id": "",
        "otp": "123456"
      },
      "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-00042"
      }
    }
  }'

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