Référence API

URL de base, en-têtes obligatoires, format des requêtes et des réponses pour tous les endpoints LigdiCash.

​

URL de base

Tous les endpoints sont accessibles sur :

https://app.ligdicash.com

Il n’existe pas d’URL sandbox distincte. Durant la phase d’intégration, vous utilisez cette même URL avec les clés de votre compte temporaire. Voir Environnements.

​

En-têtes obligatoires

Toutes les requêtes doivent inclure ces en-têtes :

En-tête	Valeur
Apikey	Clé API de votre projet
Authorization	Bearer {API_TOKEN}
Accept	application/json
Content-Type	application/json (requêtes POST uniquement)

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

Voir Authentification pour obtenir vos clés.

​

Format des requêtes

Les corps de requête sont en JSON. L’objet racine est toujours commande pour les endpoints de création de transaction.

​

Format des réponses

Toutes les réponses sont en JSON. Les champs communs à toutes les réponses :

Champ	Type	Description
response_code	string	"00" = succès, "01" = erreur
token	string	Token de la transaction (vide en cas d’erreur)
response_text	string	Message ou sous-code d’erreur (Echec (CodeXX))
wiki	string	URL vers la liste des sous-codes pour cet endpoint

response_code: "00" indique que la requête API a abouti, pas nécessairement que la transaction est complétée. Utilisez le champ status (via confirm ou callback) pour connaître le résultat du paiement.

​

Versionnement

L’API LigdiCash expose deux versions :

Version	Endpoints	Usage
v01	Tous les endpoints payin et payout standard	Opérateurs mobile money et flux général
v02	/pay/v02/debitotp et /pay/v02/debitwallet/withotp	Wallet LigdiCash uniquement

​

Endpoints disponibles

Payin redirect — create

POST /pay/v01/redirect/checkout-invoice/create

Payin — confirm

GET /pay/v01/redirect/checkout-invoice/confirm

Payin sans redirect — create

POST /pay/v01/straight/checkout-invoice/create

Wallet — envoyer OTP

GET /pay/v02/debitotp/{phone}/{amount}

Wallet — soumettre paiement

POST /pay/v02/debitwallet/withotp

Payout wallet — create

POST /pay/v01/withdrawal/create

Payout mobile money — create

POST /pay/v01/straight/payout

Payout — confirm

GET /pay/v01/withdrawal/confirm/