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
PaysBurkina Faso
OpérateurOrange Burkina
operator_id11
operator_nameORANGE BURKINA
Indicatif+226
Format du numéro22670XXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationOTP USSD

​
Mode de validation : OTP USSD

Le client génère son OTP en composant le code USSD *144*4*6# sur son téléphone avant de vous le communiquer. Vous soumettez une seule requête avec le numéro et l’OTP. L’opérateur valide la transaction côté réseau — ce traitement peut prendre quelques secondes à plusieurs minutes. Le callback est la source de vérité.
Affichez le code USSD à composer (*144*4*6#) avec des instructions claires avant que le client ne remplisse le formulaire. L’OTP généré a une durée de validité courte — invitez le client à le saisir immédiatement.

​
UX recommandée

1

Afficher les instructions USSD

Avant tout formulaire, indiquez au client de composer *144*4*6# sur son téléphone Orange. Un code OTP à usage unique s’affiche sur son écran.
2

Collecter le numéro et l'OTP

Votre formulaire recueille en même temps :
  • le numéro de téléphone Orange au format 22670XXXXXXX
  • le code OTP reçu via USSD
3

Soumettre la requête

Une seule requête API avec customer et otp renseignés.
4

Afficher un indicateur d'attente

La validation par l’opérateur peut prendre de quelques secondes à plusieurs minutes. Affichez un état d’attente et attendez le callback.

​
Exemple de requête

curl -X POST https://app.ligdicash.com/pay/v01/straight/checkout-invoice/create \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "commande": {
      "invoice": {
        "items": [],
        "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 immédiatement après la création. Utilisez-le pour appeler confirm à la réception du callback — ne vous fiez pas au token présent dans le payload du callback.

​
Limites

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

​
Pages associées