MTN Mobile Money — Côte d'Ivoire

Integrate MTN Mobile Money Côte d’Ivoire with the LigdiCash API. Validation mode: Guided USSD.

Identity

Field	Value
Country	Côte d’Ivoire
Operator	MTN Mobile Money Côte d’Ivoire
operator_id	15
operator_name	MTN CI
Country code	+225
Number format	225XXXXXXXXXX (no + or spaces)
Endpoint	POST /pay/v01/straight/checkout-invoice/create
Validation mode	Guided USSD

Validation mode: Guided USSD

After your request, MTN sends an SMS to the customer with the transaction reference and the USSD code to dial to approve the payment. The customer dials this code on their phone — they reach a USSD menu asking them to confirm with their MoMo PIN. No extra input on the merchant side: the callback remains the source of truth.

Example SMS received by the customer:

Vous avez reçu une demande de débit avec la référence 1692100357.
Tapez *133# puis choisissez l'option retrait pour approuver.

The SMS arrives within seconds, but the customer may take several minutes to read it and dial the USSD. Keep the waiting state until the callback arrives.

Recommended UX

1. Collect the customer's number

   Your form only collects the MTN phone number. No OTP to collect at this stage.

2. Submit the request

   Request with the number in customer and otp: "".

3. Show a waiting message

   After submission, display:

   “You will receive an SMS on your phone with the instructions to validate the payment. Dial the USSD code shown and confirm with your MoMo PIN.”

   Keep the waiting state until the callback arrives.

Request example

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": "Pro Subscription — January 2025",
        "customer": "2250505000000",
        "customer_firstname": "Aïssata",
        "customer_lastname": "Bamba",
        "customer_email": "[e-mail]",
        "external_id": "",
        "otp": ""
      },
      "store": {
        "name": "MyApp",
        "website_url": "https://myapp.com"
      },
      "actions": {
        "cancel_url": "",
        "return_url": "",
        "callback_url": "https://myapp.com/api/callback/ligdicash"
      },
      "custom_data": {
        "transaction_id": "ORD-2025-00056"
      }
    }
  }'

Expected response

Success (create)

{
  "response_code": "00",
  "token": "eyJ0eXAiOiJKV1Qi...",
  "response_text": "Votre requête est en cours de traitement",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}

Store the token immediately after creation. Use it to call confirm when the callback is received — never rely on the token in the callback payload.

Limits

Parameter	Value
Minimum amount	10 XOF
Maximum amount	—
Daily limit	—

Related pages

• Validation modes — Guided USSD — flow details
• Create a transaction — full endpoint reference
• Verify the status — call confirm after the callback