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
CountryMali
OperatorOrange Money Mali
operator_id18
operator_nameORANGE MALI
Country code+223
Number format223XXXXXXXX (no + or spaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Validation modeOperator redirect

​
Validation mode: Operator redirect

For Orange Money Mali, the LigdiCash integration goes through the Orange Money web portal to authenticate the customer. The flow is:
  1. You call /pay/v01/straight/checkout-invoice/create with the customer’s number.
  2. LigdiCash responds with the transaction token and a response_text field containing the Orange Money portal URL (https://mpayment.orange-money.com/ml/...).
  3. You redirect the customer’s browser to that URL.
  4. The customer authenticates and confirms the payment on the Orange portal.
  5. LigdiCash notifies you of the final result via your callback_url.
The customer’s browser-side return after the Orange portal is not guaranteed — the user may close the tab, lose connectivity, or never return. The callback remains the only source of truth. Never validate the payment based on the customer’s return alone.
This mode does use the /straight/checkout-invoice/create endpoint (direct payin), but the user journey includes an external redirect to the operator’s portal. Do not confuse this with hosted payin, which uses the /redirect/checkout-invoice/create endpoint and exposes the LigdiCash payment page.
1

Collect the customer's number

Your form only collects the Orange Money Mali phone number.
2

Submit the request

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

Retrieve the portal URL

In the response, the response_text field contains the Orange Money portal URL (https://mpayment.orange-money.com/ml/...).
4

Redirect the customer

Redirect the customer’s browser to that URL. The customer authenticates on the Orange portal and confirms the payment.
5

Wait for the callback

The final result arrives via your callback_url. Show a waiting state until the callback arrives — do not rely on the browser-side return.

​
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": "22370000000",
        "customer_firstname": "Ibrahim",
        "customer_lastname": "Traoré",
        "customer_email": "ibrahim@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-00062"
      }
    }
  }'

​
Expected response

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "response_text": "https://mpayment.orange-money.com/ml/mpayment/abstract/v1nd8lrkjniiezp3gus76kvmlgztvuylkcs2y5kiir6stko13emvuabrv95oaufb",
  "description": "",
  "custom_data": {
    "transaction_id": "ORD-2025-00062",
    "logfile": "202605111744086a021568f2037"
  },
  "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—