Skip to main content
POST
/
api
/
v1
/
msisdn
/
detect
Détection opérateur depuis un numéro MSISDN
curl --request POST \
  --url https://payments.winam.cm/api/v1/msisdn/detect \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "msisdn": "<string>",
  "country_code": "CM"
}
'
{
  "msisdn_normalized": "<string>",
  "is_valid": true,
  "country_code": "<string>",
  "operator": "mtn",
  "operator_display_name": "MTN Mobile Money",
  "provider_suggestion": "sim_gateway_mtn",
  "provider_display_name": "MTN Mobile Money",
  "provider_logo_url": "<string>",
  "error": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.winampay.de/llms.txt

Use this file to discover all available pages before exploring further.

​
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.

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