Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://developers.ligdicash.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Identité

ChampValeur
OpérateurWallet LigdiCash
operator_id-
operator_nameLIGDICASH [NOM_OPERATEUR]
Format du numéroindicatif + numéro local (sans + ni espaces)
Mode de validationOTP SMS
Le Wallet LigdiCash utilise deux endpoints distincts des autres opérateurs (/v02). Le flux est différent : un premier appel déclenche l’envoi de l’OTP, un second appel soumet la transaction avec l’OTP.

​
Mode de validation : OTP SMS

Le client reçoit un code OTP sur son application ou par SMS LigdiCash après votre première requête. Il vous communique ce code. Vous soumettez ensuite une seconde requête avec l’OTP pour finaliser la transaction.

​
UX recommandée

1

Collecter le numéro du client

Votre formulaire recueille le numéro de téléphone associé au compte LigdiCash du client.
2

Envoyer l'OTP — première requête

Appelez GET /pay/v02/debitotp/{phone_number}/{amount}. LigdiCash envoie un OTP au client.
3

Afficher le champ OTP

Après confirmation de l’envoi ("error": false), affichez un champ de saisie pour l’OTP. Indiquez au client de vérifier son application ou ses SMS LigdiCash.
4

Soumettre avec l'OTP — seconde requête

Appelez POST /pay/v02/debitwallet/withotp avec le numéro dans customer et l’OTP dans otp.
5

Attendre le callback

Affichez un indicateur d’attente. La confirmation arrive via votre callback_url.

​
Étape 1 — Envoyer l’OTP

GET https://app.ligdicash.com/pay/v02/debitotp/{phone_number}/{amount}
Les paramètres phone_number et amount sont des paramètres de chemin (path parameters), pas un body JSON.

​
Headers

​
Apikey
string
requis
La clé API de votre projet LigdiCash.
​
Authorization
string
requis
Votre API TOKEN précédé de Bearer .
​
Accept
string
requis
Doit être application/json.

​
Paramètres de chemin

​
phone_number
string
requis
Numéro de téléphone du client au format indicatif + numéro local, sans + ni espaces.
​
amount
integer
requis
Montant en XOF (entier, sans décimales).

​
Exemple

curl -X GET "https://app.ligdicash.com/pay/v02/debitotp/22670000000/5000" \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json"

​
Réponse

Succès
{
  "error": false,
  "message": "OTP sent. Please check your phone."
}
Vérifiez que error vaut false avant d’afficher le champ OTP. Si error est true, affichez un message d’erreur et ne proposez pas la saisie de l’OTP.

​
Étape 2 — Valider avec l’OTP

POST https://app.ligdicash.com/pay/v02/debitwallet/withotp

​
Headers

​
Apikey
string
requis
La clé API de votre projet LigdiCash.
​
Authorization
string
requis
Votre API TOKEN précédé de Bearer .
​
Accept
string
requis
Doit être application/json.
​
Content-Type
string
requis
Doit être application/json.

​
Body

Même structure que l’endpoint /pay/v01/straight/checkout-invoice/create, avec customer renseigné et otp contenant le code reçu par le client.

​
Exemple

curl -X POST https://app.ligdicash.com/pay/v02/debitwallet/withotp \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "commande": {
      "invoice": {
        "items": [
          {
            "name": "Abonnement Pro",
            "description": "Accès premium 1 mois",
            "quantity": 1,
            "unit_price": 5000,
            "total_price": 5000
          }
        ],
        "total_amount": 5000,
        "devise": "XOF",
        "description": "Abonnement Pro — Janvier 2025",
        "customer": "22670000000",
        "customer_firstname": "Amadou",
        "customer_lastname": "Diallo",
        "customer_email": "amadou@exemple.com",
        "external_id": "",
        "otp": "123456"
      },
      "store": {
        "name": "MonApp",
        "website_url": "https://monapp.com"
      },
      "actions": {
        "cancel_url": "",
        "return_url": "",
        "callback_url": "https://monapp.com/api/callback/ligdicash"
      },
      "custom_data": {
        "transaction_id": "ORD-2025-00042"
      }
    }
  }'

​
Réponse attendue

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "Votre requête est en cours de traitement",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}
Stockez le token retourné par /debitwallet/withotp. C’est lui que vous utiliserez pour appeler confirm à la réception du callback.

​
Limites

ParamètreValeur
Montant minimum10 XOF
Montant maximum2 000 000 XOF
Limite quotidienne—

​
Pages associées