Skip to main content
POST
Detect operator from an MSISDN

Typical integration flow

1

Player enters their phone number

Your UI collects the player’s MSISDN at checkout.
2

Detect the operator

Call POST /msisdn/detect with the raw number — winam-payments normalizes it to E.164 and identifies the operator.
3

Pre-fill the deposit/withdrawal request

Use operator from the response directly in your POST /deposits or POST /withdrawals call — no manual selection required.
Currently supported country: CM (Cameroon). country_code defaults to CM if omitted.

Cameroon prefix table

POST /deposits and POST /withdrawals enforce this table: a request whose msisdn prefix clearly contradicts the operator field (e.g. a 655… Orange number with operator=mtn) is rejected with 422 before any USSD is sent. Numbers with unknown prefixes are accepted as-is.

Authorizations

X-API-Key
string
header
required

Body

application/json
msisdn
string
required

Phone number in local or E.164 format

Example:

"+237670123456"

country_code
string
default:CM

ISO 3166-1 alpha-2 country code. Currently only CM (Cameroon) is supported.

Example:

"CM"

Response

Successful Response

msisdn_normalized
string
required

MSISDN normalised to E.164 format

Example:

"+237670123456"

is_valid
boolean
required

Whether the MSISDN is a recognised Cameroon number

country_code
string
required
Example:

"CM"

operator
string | null
required

Detected operator: "mtn" | "orange" | null

Example:

"mtn"

operator_display_name
string | null
required
Example:

"MTN Mobile Money"

provider_suggestion
string | null
required

Suggested provider_id to use in the deposit/withdrawal request

Example:

"sim_gateway_mtn"

provider_display_name
string | null
required
Example:

"MTN Mobile Money"

provider_logo_url
string | null
required
error
string | null

Error message if is_valid is false