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érateurMoov Africa Burkina
operator_id12
operator_nameMOOV AFRICA BURKINA
Indicatif+226
Format du numéro226XXXXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationUSSD Push (fallback : USSD guidé)

​
Modes de validation

Moov Africa Burkina Faso utilise deux modes selon la disponibilité réseau au moment de la transaction. Vous soumettez la même requête dans les deux cas — c’est l’opérateur qui décide du mode côté réseau. Mode principal — USSD Push : après votre requête, l’opérateur envoie directement un écran USSD push sur le téléphone du client. Le client valide avec son code PIN. Aucune saisie supplémentaire côté marchand. Mode fallback — USSD guidé : si le push n’aboutit pas, l’opérateur envoie un SMS contenant les instructions et le code USSD à composer. Le client compose le USSD pour valider.
Votre UX doit anticiper les deux cas. Affichez un message qui couvre les deux : le client recevra soit un push USSD à valider directement, soit un SMS avec les instructions à suivre.

​
UX recommandée

1

Collecter le numéro du client

Votre formulaire recueille uniquement le numéro de téléphone Moov. Aucun OTP à collecter.
2

Soumettre la requête

Requête avec le numéro dans customer et otp: "".
3

Afficher un message d'attente

Après soumission, affichez un message du type :
« Validez le paiement sur votre téléphone. Vous allez recevoir une demande de validation USSD, ou un SMS avec les instructions à suivre. »
Maintenez cet état d’attente jusqu’à la réception du 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": "22660000000",
        "customer_firstname": "Aminata",
        "customer_lastname": "Sawadogo",
        "customer_email": "aminata@exemple.com",
        "external_id": "",
        "otp": ""
      },
      "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-00043"
      }
    }
  }'

​
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 minimum100 XOF
Montant maximum2 000 000 XOF
Limite quotidienne—

​
Pages associées