Passer au contenu principal
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.
ValeurSignification
00Requête valide — la transaction est initiée
01Requê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 :
FluxContenu de response_text
Payin avec redirectionL’URL de la page de paiement LigdiCash — c’est ce lien que vous devez ouvrir pour le client
Payin sans redirectionUn 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"
}

​
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