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 |
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 -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 :
LIGDICASH_API_KEY=votre_api_key
LIGDICASH_API_TOKEN=votre_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"
}
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.
