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.

Base URL

All endpoints are reachable at:
https://app.ligdicash.com
There is no separate sandbox URL. During integration, you use the same URL with the credentials of your temporary account. See Environments.

Required headers

All requests must include these headers:
HeaderValue
ApikeyAPI key of your project
AuthorizationBearer {API_TOKEN}
Acceptapplication/json
Content-Typeapplication/json (POST requests only)
curl -X POST https://app.ligdicash.com/pay/v01/... \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"
See Authentication to obtain your credentials.

Request format

Request bodies are in JSON. The root object is always commande for transaction creation endpoints.

Response format

All responses are in JSON. Fields common to all responses:
FieldTypeDescription
response_codestring"00" = success, "01" = error
tokenstringTransaction token (empty on error)
response_textstringMessage or error sub-code (Echec (CodeXX))
wikistringURL to the list of sub-codes for this endpoint
response_code: "00" means the API request succeeded, not necessarily that the transaction is completed. Use the status field (via confirm or callback) to know the payment outcome.

Versioning

The LigdiCash API exposes two versions:
VersionEndpointsUsage
v01All standard payin and payout endpointsMobile money operators and general flow
v02/pay/v02/debitotp and /pay/v02/debitwallet/withotpLigdiCash Wallet only

Available endpoints

Hosted payin — create

POST /pay/v01/redirect/checkout-invoice/create

Payin — confirm

GET /pay/v01/redirect/checkout-invoice/confirm

Direct payin — create

POST /pay/v01/straight/checkout-invoice/create

Wallet — send OTP

GET /pay/v02/debitotp/{phone}/{amount}

Wallet — submit payment

POST /pay/v02/debitwallet/withotp

Wallet payout — create

POST /pay/v01/withdrawal/create

Mobile money payout — create

POST /pay/v01/straight/payout

Payout — confirm

GET /pay/v01/withdrawal/confirm/