Anatomie du payload — Payin

Détail de chaque champ du payload reçu lors d’un paiement entrant. Exemple réel et explication champ par champ.

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": "[e-mail]",
    "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.

Afficher Structure d'un élément

keyof_customdata · string

Clé de la donnée.

valueof_customdata · string

Valeur de la donnée.

datecreation_customdata · string

Horodatage de création de la donnée.

LigdiCash ajoute systématiquement deux entrées à votre custom_data :

keyof_customdata	Origine	Description
hash	LigdiCash	Hash de la transaction généré par LigdiCash
logfile	LigdiCash	Ré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.

Afficher Champs

firstname · string

Prénom.

lastname · string

Nom.

email · string

Adresse email.

phone · string

Numéro de téléphone.

details · string

Informations complémentaires. Généralement vide.

​

Pages associées

• Sécurisation du callback
• Parser custom_data
• Idempotence et déduplication