Skip to main content

Identity

Validation mode: USSD OTP

The customer generates their OTP by dialing the USSD code *144*4*6# on their phone before sharing it with you. You submit a single request with the number and the OTP. The operator validates the transaction on the network side — this processing can take from a few seconds to several minutes. The callback is the source of truth.
Display the USSD code to dial (*144*4*6#) with clear instructions before the customer fills out the form. The generated OTP has a short validity period — encourage the customer to enter it immediately.
1

Show the USSD instructions

Before any form, tell the customer to dial *144*4*6# on their Orange phone. A one-time OTP code appears on their screen.
2

Collect the number and the OTP

Your form collects, at the same time:
  • the Orange phone number in the format 22670XXXXXXX
  • the OTP code received via USSD
3

Submit the request

A single API request with customer and otp filled.
4

Show a waiting indicator

Operator validation can take from a few seconds to several minutes. Show a waiting state and wait for the callback.

Request example

Expected response

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