Skip to main content
POST
/
pay
/
v01
/
withdrawal
/
create
Create a wallet payout
curl --request POST \
  --url https://app.ligdicash.com/pay/v01/withdrawal/create \
  --header 'Accept: <accept>' \
  --header 'Apikey: <apikey>' \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "commande": {
    "amount": 123,
    "description": "<string>",
    "customer": "<string>",
    "callback_url": "<string>",
    "top_up_wallet": 123,
    "custom_data": {}
  }
}
'
{
  "response_code": "<string>",
  "token": "<string>",
  "response_text": "<string>",
  "description": "<string>",
  "custom_data": [
    {}
  ],
  "wiki": "<string>"
}

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.

The beneficiary must have a LigdiCash account. To send directly to a mobile money number without a LigdiCash account, use POST /pay/v01/straight/payout.

Headers

Apikey
string
required
API key of the LigdiCash project.
Authorization
string
required
Bearer {API_TOKEN}
Accept
string
required
application/json
Content-Type
string
required
application/json

Body

commande
object
required

Response

response_code
string
"00" = payout initiated, any other value = error.
token
string
Payout token. Store it — required to verify the status.
response_text
string
Associated message. Can be empty.
description
string
Additional description. Can be empty.
custom_data
array
Always [].
wiki
string
URL to the sub-codes documentation.
{
  "response_code": "00",
  "token": "{PAYOUT_TOKEN}",
  "response_text": "",
  "description": "",
  "custom_data": [],
  "wiki": "https://client.ligdicash.com/wiki/createWithdrawal"
}

Error codes

Wiki: https://client.ligdicash.com/wiki/createWithdrawal — see Sub-codes per endpoint. Customer payout — to LigdiCash wallet — use cases and top_up_wallet details.