Identity
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: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
Expected response
Limits
Related pages
- Validation modes — USSD Push & Guided USSD — details of the two flows
- Create a transaction — full endpoint reference
- Verify the status — call
confirmafter the callback
