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>"
}

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/json

Query 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

Metadata enriched by LigdiCash.

Show Entry fields

string

Key. LigdiCash adds its own entries (logfile).

string

Value.

string

Creation timestamp of the entry.

object

Show Fields

string

First name.

string

Last name.

string

Email.

string

Phone.

string

Additional information.

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.

Create a hosted payin invoice Create a direct payin transaction

Reference

Endpoints — Payin

Endpoints — Payout

Verify the status of a payin invoice

Headers

Query parameter

Response

Error codes

​Headers

​Query parameter

​Response

​Error codes

​Related guides

Headers

Query parameter

Response

Error codes

Related guides