Authentification

Comment authentifier vos requêtes vers l’API LigdiCash avec les en-têtes Apikey et Authorization.

Chaque requête vers l’API LigdiCash doit être accompagnée de deux clés d’identification, transmises dans les en-têtes HTTP. Ces clés sont disponibles dans votre dashboard LigdiCash une fois votre projet activé.

​

Les deux clés

En-tête	Valeur	Rôle
Apikey	Votre clé API	Identifie votre projet
Authorization	Bearer {API_TOKEN}	Authentifie la requête

Ces deux clés sont distinctes et toutes les deux obligatoires. Une requête avec une seule des deux sera rejetée.

Une fois votre projet activé, vos clés Apikey et API_TOKEN sont disponibles directement dans votre dashboard LigdiCash.

​

En-têtes complets

Toutes vos requêtes doivent inclure ces quatre en-têtes :

Apikey: {API_KEY}
Authorization: Bearer {API_TOKEN}
Accept: application/json
Content-Type: application/json

​

Exemple cURL

cURL

curl -X POST https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/create \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

​

Bonnes pratiques

Stockez vos clés dans des variables d’environnement, jamais en dur dans le code source :

.env

LIGDICASH_API_KEY=votre_api_key
LIGDICASH_API_TOKEN=votre_api_token

const apiKey = process.env.LIGDICASH_API_KEY;
const apiToken = process.env.LIGDICASH_API_TOKEN;

$apiKey = getenv('LIGDICASH_API_KEY');
$apiToken = getenv('LIGDICASH_API_TOKEN');

import os
api_key = os.environ["LIGDICASH_API_KEY"]
api_token = os.environ["LIGDICASH_API_TOKEN"]

Ne transmettez jamais vos clés depuis un navigateur ou une application mobile. Tout appel à l’API LigdiCash doit transiter par votre serveur backend.

​

Erreurs d’authentification

Une erreur d’authentification se manifeste par response_code: "01" et response_text: "Echec (Code00)" :

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

Causes possibles :

• Apikey incorrecte ou expiré
• API_TOKEN incorrect ou expiré
• Un ou plusieurs en-têtes obligatoires absents

Le champ wiki présent dans chaque réponse contient une URL vers la documentation des codes d’erreur spécifique à l’endpoint appelé. Consultez toujours cette URL pour obtenir la signification exacte du code retourné — c’est la référence officielle LigdiCash pour interpréter response_text.

​

Régénérer vos clés

Si vos clés sont compromises, contactez l’équipe LigdiCash pour en obtenir de nouvelles. Les anciennes clés sont immédiatement invalidées à la réémission.

Toute réémission de clés interrompt immédiatement les appels en production. Préparez vos nouvelles variables d’environnement avant de demander la réémission.