Skip to main content
GET
/
pay
/
v01
/
redirect
/
checkout-invoice
/
confirm
Verify the status of a payin invoice
curl --request GET \
  --url https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm \
  --header 'Accept: <accept>' \
  --header 'Apikey: <apikey>' \
  --header 'Authorization: <authorization>'
{
  "response_code": "<string>",
  "status": "<string>",
  "token": "<string>",
  "response_text": "<string>",
  "description": "<string>",
  "operator_id": "<string>",
  "operator_name": "<string>",
  "customer": "<string>",
  "montant": 123,
  "amount": 123,
  "date": "<string>",
  "external_id": "<string>",
  "oreference": "<string>",
  "request_id": "<string>",
  "custom_data": [
    {
      "keyof_customdata": "<string>",
      "valueof_customdata": "<string>",
      "datecreation_customdata": "<string>"
    }
  ],
  "customer_details": {
    "firstname": "<string>",
    "lastname": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "details": "<string>"
  },
  "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.

Headers

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

Query parameter

token
string
required
Token returned by the create endpoint at invoice creation. Do not use the callback token — they are different.

Response

response_code
string
"00" = call succeeded, "01" = technical error.
status
string
Payment status: completed, pending, or notcompleted.
token
string
Empty in the confirm response.
response_text
string
Error sub-code if response_code = "01", empty otherwise.
description
string
Free-form description. Can be empty.
operator_id
string
Identifier of the operator used. Empty if status = pending.
operator_name
string
Operator name. Empty if status = pending.
customer
string
Payer’s number. null if status = pending.
montant
integer
Amount in XOF.
amount
integer
Same as montant.
date
string
Transaction date. Format: YYYY-MM-DD HH:MM:SS+TZ.
external_id
string
Concatenation of valueof_customdata values whose key contains "id". Matches the transaction_id if the pattern is respected.
oreference
string
Operator reference. Can be empty.
request_id
string
Unique LigdiCash identifier. Useful for support.
custom_data
array
Metadata enriched by LigdiCash.
customer_details
object
wiki
string
URL to the sub-codes documentation.
statusMeaning
completedPayment confirmed
pendingAwaiting operator processing
notcompletedPayment did not go through
{
  "response_code": "00",
  "status": "completed",
  "operator_id": "14",
  "operator_name": "MOOV CI",
  "customer": "2250171584035",
  "montant": 5000,
  "amount": 5000,
  "date": "2026-04-15 11:19:28+00",
  "external_id": "ORD-2025-00042",
  "oreference": "",
  "request_id": "P2771491712026",
  "token": "",
  "response_text": "",
  "description": "",
  "custom_data": [
    { "keyof_customdata": "transaction_id", "valueof_customdata": "ORD-2025-00042", "datecreation_customdata": "2026-04-15 11:19:28.977757" },
    { "keyof_customdata": "logfile", "valueof_customdata": "2026041511192869df7440ed917", "datecreation_customdata": "2026-04-15 11:19:28.977757" }
  ],
  "customer_details": { "firstname": "Amadou", "lastname": "Diallo", "email": "amadou@example.com", "phone": "2250171584035", "details": "" },
  "wiki": "https://client.ligdicash.com/wiki/confirmInvoice"
}

Error codes

Wiki: https://client.ligdicash.com/wiki/confirmInvoice — see Sub-codes per endpoint.