Moov Africa — Burkina Faso

Integrate Moov Africa Burkina Faso with the LigdiCash API. Validation mode: USSD Push with Guided USSD fallback.

Identity

Field	Value
Country	Burkina Faso
Operator	Moov Africa Burkina
operator_id	12
operator_name	MOOV AFRICA BURKINA
Country code	+226
Number format	226XXXXXXXXX (no + or spaces)
Endpoint	POST /pay/v01/straight/checkout-invoice/create
Validation mode	USSD Push (fallback: Guided USSD)

Validation modes

Moov Africa Burkina Faso 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 PIN. No extra input on the merchant side.

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

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": "22660000000",
        "customer_firstname": "Aminata",
        "customer_lastname": "Sawadogo",
        "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-00043"
      }
    }
  }'

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	2,000,000 XOF
Daily limit	—

Related pages

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