Passer au contenu principal

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.

Lors d’un paiement entrant, LigdiCash envoie deux requêtes POST à votre callback_url — une en application/json, une en application/x-www-form-urlencoded. Les deux contiennent les mêmes données. Cette page détaille la structure JSON.

​
Exemple complet

{
  "date": "2026-05-09 07:20:23+00",
  "wiki": "https://client.ligdicash.com/wiki/confirmInvoice",
  "token": "",
  "amount": 4200,
  "status": "completed",
  "montant": 4200,
  "customer": "22676275726",
  "oreference": "",
  "request_id": "P2777636082026",
  "custom_data": [
    {
      "keyof_customdata": "transaction_id",
      "valueof_customdata": "ART5A7044E5",
      "datecreation_customdata": "2026-05-09 07:20:23.362788"
    },
    {
      "keyof_customdata": "hash",
      "valueof_customdata": "f918c54d54cdc334ade09f8c228a224b1d3df646250c84dcdd99af528ddcd450",
      "datecreation_customdata": "2026-05-09 07:20:23.362788"
    },
    {
      "keyof_customdata": "logfile",
      "valueof_customdata": "2026050907202369fee03756652",
      "datecreation_customdata": "2026-05-09 07:20:23.362788"
    }
  ],
  "description": "",
  "external_id": "ART5A7044E5",
  "operator_id": "11",
  "operator_name": "ORANGE BURKINA",
  "response_code": "00",
  "response_text": "",
  "customer_details": {
    "email": "prenom.nom@example.com",
    "phone": "22676275726",
    "details": "",
    "lastname": "NOM",
    "firstname": "Prénom"
  }
}

​
Champs principaux

​
date
string
Horodatage de l’événement au format YYYY-MM-DD HH:MM:SS+TZ.
​
response_code
string
Code de résultat. "00" = succès. Toute autre valeur indique une erreur — consultez wiki pour le détail.
​
status
string
Statut de la transaction : "completed", "pending" ou "notcompleted". Basez votre logique métier sur ce champ.
​
amount
integer
Montant de la transaction en XOF.
​
montant
integer
Identique à amount. Les deux champs coexistent dans toutes les réponses LigdiCash.
​
customer
string
Numéro de téléphone du payeur, avec indicatif pays, sans + ni espaces.
​
request_id
string
Identifiant unique de la requête généré par LigdiCash. Utilisez-le pour la déduplication lorsque custom_data est vide ou inaccessible.
​
external_id
string
Concaténation des valeurs de tous les champs de custom_data dont la clé contient "id". Peut être fiable si vous n’avez qu’un seul champ avec "id" dans le nom — mais parsez custom_data directement pour un résultat garanti.
​
token
string
Toujours vide (""). Ce champ n’est pas utilisable pour la vérification — utilisez le token stocké à la création de la transaction.
​
operator_id
string
Identifiant de l’opérateur qui a traité le paiement (ex : "11" pour Orange Burkina).
​
operator_name
string
Nom de l’opérateur (ex : "ORANGE BURKINA").
​
description
string
Description de la transaction. Peut être vide.
​
oreference
string
Référence opérateur. Peut être vide.
​
response_text
string
Libellé textuel du résultat. Peut être vide.
​
wiki
string
URL vers la documentation des codes d’erreur de cet endpoint. À consulter quand response_code !== "00".

​
Le tableau custom_data

​
custom_data
array
Tableau des données personnalisées associées à la transaction. Contient vos champs marchands plus les champs ajoutés automatiquement par LigdiCash.
LigdiCash ajoute systématiquement deux entrées à votre custom_data :
keyof_customdataOrigineDescription
hashLigdiCashHash de la transaction généré par LigdiCash
logfileLigdiCashRéférence de log interne LigdiCash
Filtrez toujours sur keyof_customdata pour extraire vos propres champs. Voir Parser custom_data.

​
Les informations client

​
customer_details
object
Informations du payeur si disponibles.

​
Pages associées