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
PaysCôte d’Ivoire
OpérateurMTN Mobile Money Côte d’Ivoire
operator_id15
operator_nameMTN CI
Indicatif+225
Format du numéro225XXXXXXXXXX (sans + ni espaces)
EndpointPOST /pay/v01/straight/checkout-invoice/create
Mode de validationUSSD guidé

​
Mode de validation : USSD guidé

Après votre requête, MTN envoie un SMS au client contenant la référence de la transaction et le code USSD à composer pour approuver le paiement. Le client compose ce code sur son téléphone — il accède à un menu USSD qui lui demande de confirmer avec son code PIN MoMo. Aucune saisie supplémentaire côté marchand : le callback reste la source de vérité. Exemple de SMS reçu par le client : 
Vous avez reçu une demande de débit avec la référence 1692100357.
Tapez *133# puis choisissez l'option retrait pour approuver.
Le SMS arrive en quelques secondes mais le client peut prendre plusieurs minutes pour le lire et composer le USSD. Conservez l’état d’attente jusqu’à la réception du callback.

​
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 à ce stade.
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 :
« Vous allez recevoir un SMS sur votre téléphone avec les instructions pour valider le paiement. Composez le code USSD indiqué et confirmez 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": "2250505000000",
        "customer_firstname": "Aïssata",
        "customer_lastname": "Bamba",
        "customer_email": "aissata@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-00056"
      }
    }
  }'

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

​
Pages associées