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>'import requests
url = "https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm"
headers = {
"Apikey": "<apikey>",
"Authorization": "<authorization>",
"Accept": "<accept>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Apikey: '<apikey>', Authorization: '<authorization>', Accept: '<accept>'}
};
fetch('https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Accept: <accept>",
"Apikey: <apikey>",
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Apikey", "<apikey>")
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Accept", "<accept>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm")
.header("Apikey", "<apikey>")
.header("Authorization", "<authorization>")
.header("Accept", "<accept>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Apikey"] = '<apikey>'
request["Authorization"] = '<authorization>'
request["Accept"] = '<accept>'
response = http.request(request)
puts response.read_body{
"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>"
}Endpoints — Payin
Verify the status of a payin invoice
Verifies the status of a payin invoice (hosted or direct) from the creation token.
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>'import requests
url = "https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm"
headers = {
"Apikey": "<apikey>",
"Authorization": "<authorization>",
"Accept": "<accept>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Apikey: '<apikey>', Authorization: '<authorization>', Accept: '<accept>'}
};
fetch('https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Accept: <accept>",
"Apikey: <apikey>",
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Apikey", "<apikey>")
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Accept", "<accept>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm")
.header("Apikey", "<apikey>")
.header("Authorization", "<authorization>")
.header("Accept", "<accept>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/confirm")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Apikey"] = '<apikey>'
request["Authorization"] = '<authorization>'
request["Accept"] = '<accept>'
response = http.request(request)
puts response.read_body{
"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>"
}Headers
string
required
API key of the LigdiCash project.
string
required
Bearer {API_TOKEN}string
required
application/jsonQuery parameter
string
required
Token returned by the
create endpoint at invoice creation. Do not use the callback token — they are different.Response
string
"00" = call succeeded, "01" = technical error.string
Payment status:
completed, pending, or notcompleted.string
Empty in the
confirm response.string
Error sub-code if
response_code = "01", empty otherwise.string
Free-form description. Can be empty.
string
Identifier of the operator used. Empty if
status = pending.string
Operator name. Empty if
status = pending.string
Payer’s number.
null if status = pending.integer
Amount in XOF.
integer
Same as
montant.string
Transaction date. Format:
YYYY-MM-DD HH:MM:SS+TZ.string
Concatenation of
valueof_customdata values whose key contains "id". Matches the transaction_id if the pattern is respected.string
Operator reference. Can be empty.
string
Unique LigdiCash identifier. Useful for support.
array
object
string
URL to the sub-codes documentation.
status | Meaning |
|---|---|
completed | Payment confirmed |
pending | Awaiting operator processing |
notcompleted | Payment 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"
}
{
"response_code": "00",
"status": "pending",
"operator_id": "",
"operator_name": "",
"customer": null,
"montant": 5000,
"amount": 5000,
"date": "2026-04-22 16:51:02+00",
"external_id": "ORD-2025-00042",
"token": "",
"response_text": "",
"wiki": "https://client.ligdicash.com/wiki/confirmInvoice"
}
{
"response_code": "01",
"response_text": "Echec (Code01)",
"status": "",
"wiki": "https://client.ligdicash.com/wiki/confirmInvoice"
}
Error codes
Wiki:https://client.ligdicash.com/wiki/confirmInvoice — see Sub-codes per endpoint.
