Moov Africa — Côte d'Ivoire

Integrate Moov Africa Côte d’Ivoire with the LigdiCash API. Validation mode: USSD Push with Guided USSD fallback.

Identity

Field	Value
Country	Côte d’Ivoire
Operator	Moov Africa Côte d’Ivoire (Moov Money)
operator_id	14
operator_name	MOOV CI
Country code	+225
Number format	225XXXXXXXXXX (no + or spaces)
Endpoint	POST /pay/v01/straight/checkout-invoice/create
Validation mode	USSD Push (fallback: Guided USSD)

Validation modes

Moov Côte d’Ivoire uses two modes depending on network availability at the moment of the transaction. You submit the same request in both cases — the operator decides on the mode on the network side.

Primary mode — USSD Push: after your request, the operator pushes a USSD prompt directly to the customer’s phone. The customer validates with their Moov Money PIN. No extra input on the merchant side.

Fallback mode — Guided USSD: if the push does not go through, the operator sends an SMS containing the transaction reference and the USSD code to dial. The customer dials the USSD to validate.

Example SMS received in fallback mode:

Vous avez une transaction 0000000433 - LIGDICASH_CI en attente.
Faites *155*15# pour payer.

Your UX must anticipate both cases. Show a message that covers both: the customer will receive either a USSD push to validate directly, or an SMS with the instructions to follow.

Recommended UX

1. Collect the customer's number

   Your form only collects the Moov phone number. No OTP to collect.

2. Submit the request

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

3. Show a waiting message

   After submission, display a message like:

   “Validate the payment on your phone. You will receive a USSD validation prompt, or an SMS with the instructions to follow.”

   Keep this 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": "2250101000000",
        "customer_firstname": "Adama",
        "customer_lastname": "Koffi",
        "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-00055"
      }
    }
  }'

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	100 XOF
Maximum amount	—
Daily limit	—

Related pages

• Validation modes — USSD Push & Guided USSD — details of the two flows
• Create a transaction — full endpoint reference
• Verify the status — call confirm after the callback