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
PaysBénin
OpérateurMTN Mobile Money Bénin
operator_id1
operator_nameMTN BENIN
Indicatif+229
Format du numéro229XXXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationUSSD Push

​
Mode de validation : USSD Push

Après votre requête, l’opérateur envoie un push USSD directement sur le téléphone du client. Le client valide avec son code PIN MoMo. Aucune saisie supplémentaire côté marchand — le callback reste la source de vérité.
Affichez un message d’attente clair après soumission. Le push USSD arrive sur le téléphone du client en quelques secondes, mais le callback peut prendre de quelques secondes à plusieurs minutes selon l’opérateur.

​
UX recommandée

1

Collecter le numéro du client

Votre formulaire recueille uniquement le numéro de téléphone MTN. 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 :
« Validez le paiement sur votre téléphone. Vous allez recevoir une demande USSD à approuver avec votre code PIN MoMo. »
Maintenez l’é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": "22996000000",
        "customer_firstname": "Mawuena",
        "customer_lastname": "Kpodo",
        "customer_email": "mawuena@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-00068"
      }
    }
  }'

​
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 maximum—
Limite quotidienne—

​
Pages associées