Codes de réponse et statuts

Chaque réponse de l’API LigdiCash contient trois champs qui permettent d’interpréter le résultat d’un appel : response_code, response_text et wiki. Ils sont présents sur tous les endpoints.

response_code

Le champ response_code indique si la requête a été acceptée ou rejetée par LigdiCash.

Valeur	Signification
`00`	Requête valide — la transaction est initiée
`01`	Requête rejetée — payload invalide ou erreur d’authentification

response_code: "00" ne signifie pas que le paiement a réussi. Cela signifie uniquement que votre payload était correct et que la transaction a bien été initiée. L’issue réelle du paiement — succès ou échec — est communiquée ultérieurement via le callback ou l’endpoint confirm.

response_text

La valeur de response_text dépend à la fois du résultat et de l’endpoint appelé. En cas de succès (response_code: "00"), le contenu varie selon le type de transaction :

Flux	Contenu de `response_text`
Payin avec redirection	L’URL de la page de paiement LigdiCash — c’est ce lien que vous devez ouvrir pour le client
Payin sans redirection	Un message textuel indiquant que la transaction est en cours de traitement

En cas d’échec (response_code: "01"), il prend la forme Echec (CodeXX) où XX est un sous-code spécifique à l’endpoint — par exemple Echec (Code00) pour un échec d’authentification.

En cas d’échec, response_text est un code technique (Echec (CodeXX)). Préférez consulter le champ wiki pour en obtenir la description lisible et afficher un message adapté à votre utilisateur.

Le champ wiki

Le champ wiki présent dans chaque réponse contient une URL vers la documentation des sous-codes de l’endpoint appelé. Consultez toujours cette URL quand response_code vaut 01 pour connaître la cause exacte de l’échec. La page retournée affiche une liste structurée des sous-codes possibles et leur description, au format var_dump PHP :

array:2 [▼
  0 => array:2 [▶]
  1 => array:3 [▼
    "code" => "01"
    "description" => "There is an error"
    "subcodes" => array:19 [▼
      0 => array:2 [▼
        "code" => "Echec (Code00)"
        "description" => "Authentification failure"
      ]
      1 => array:2 [▶]
      2 => array:2 [▶]
      ...
    ]
  ]
]

Chaque entrée de subcodes correspond à une valeur possible de response_text et sa signification en anglais.

Exemple de réponse

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "https://app.ligdicash.com/pay/invoice/eyJ0eXAiOiJKV1Qi...",
  "description": "",
  "custom_data": {},
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "Transaction en cours de traitement",
  "description": "",
  "custom_data": {},
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

{
  "response_code": "01",
  "token": "",
  "response_text": "Echec (Code00)",
  "description": "",
  "custom_data": {},
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

Pattern recommandé

Node.js

const data = await response.json();

if (data.response_code === "01") {
  // Loggez le sous-code technique
  console.error("LigdiCash error:", data.response_text);

  // Consultez data.wiki pour obtenir la description du sous-code
  // et construire un message adapté à votre utilisateur
}

Pages associées

Cycle de vie d’une transaction — statuts pending, completed, notcompleted
Erreurs courantes — causes et solutions par endpoint
Le champ wiki — utilisation avancée

​response_code

​response_text

​Le champ wiki

​Exemple de réponse

​Pattern recommandé

​Pages associées

response_code

response_text

Le champ wiki

Exemple de réponse

Pattern recommandé

Pages associées