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
CountryDRC
OperatorAfricell DRC (Africell Money)
operator_id38
operator_nameAFRICELL RDC CONGO
Country code+243
Number format243XXXXXXXXX (no + or spaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Validation modeUSSD Push

Validation mode: USSD Push

After your request, the operator pushes a USSD prompt directly to the customer’s phone. The customer validates with their Africell Money PIN. No extra input on the merchant side — the callback remains the source of truth.
Show a clear waiting message after submission. The USSD push reaches the customer’s phone within seconds, but the callback can take from a few seconds to several minutes depending on the operator.
1

Collect the customer's number

Your form only collects the Africell 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:
“Validate the payment on your phone. You will receive a USSD prompt to approve with your Africell Money 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": "243990000000",
        "customer_firstname": "Patrick",
        "customer_lastname": "Lumumba",
        "customer_email": "patrick@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-00052"
      }
    }
  }'

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