MTN Mobile Money — Bénin

Intégrer MTN Mobile Money Bénin avec l’API LigdiCash. Mode de validation : USSD Push.

​

Identité

Champ	Valeur
Pays	Bénin
Opérateur	MTN Mobile Money Bénin
operator_id	1
operator_name	MTN BENIN
Indicatif	+229
Format du numéro	229XXXXXXXX (sans + ni espaces)
Endpoint	POST /pay/v01/straight/checkout-invoice/create
Mode de validation	USSD 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

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": "[e-mail]",
        "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

Succès (create)

{
  "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ètre	Valeur
Montant minimum	100 XOF
Montant maximum	—
Limite quotidienne	—

​

Pages associées

• Modes de validation — USSD Push — détail du flux
• Créer une transaction — référence complète de l’endpoint
• Vérifier le statut — appeler confirm après le callback