Mexico

Mexico eKYC verification uses phone and email risk-scoring rather than source-of-truth identity matching. See the eKYC API Reference for common response semantics.

Available sources

Source	API source string	Description
MX CONSUMER 1	`MX_Consumer_1`	Returns risk scores for phone and email based on third-party data, and an aggregate overall risk level.

{/* TODO: Confirm with PM — the existing documentation references both MX_Consumer_1 (combined phone and email) and MX_TELCO_1 (phone-only) as source values. Confirm whether these are the same backend source, and clarify how they relate to the Dashboard source "MX CONSUMER 1." */}

MX CONSUMER 1

MX CONSUMER 1 combines phone and email risk-scoring from third-party providers:

Phone returns a risk score based on account history, prepaid status, account duration, and monthly bill amount.
Email returns a predictive risk score based on historical transaction data and behavior patterns.

The request works with only phone or only email supplied. If both are provided, the response includes both individual scores and an aggregate overall risk level.

{/* TODO: Confirm with PM — the Dashboard UI locks both Email and Phone as required for MX CONSUMER 1, but existing API documentation describes an either/or relationship. Confirm which requirement is accurate for customer-facing documentation. */}

Request parameters

Parameter	Required	Description
`source`	Mandatory	Must be `MX_Consumer_1`.
`country`	Mandatory	Must be `MX`.
`phone`	Conditional	Phone number in E.164 format. Either `phone` or `email` must be provided.
`email`	Conditional	Email address. Either `phone` or `email` must be provided.
`firstName`	Optional	First name of the individual, including middle name if applicable.
`surName`	Optional	Last name of the individual.
`maternalSurname`	Optional	Maternal surname.

Response fields

Field	Statuses	Description
`phoneLevel`	`low`, `medium`, `high`, `very_high`	Risk level associated with the submitted phone number.
`phoneCarrier`	String	Phone carrier associated with the submitted phone number.
`emailLevel`	`low`, `medium`, `high`, `very_high`	Risk level associated with the submitted email address.
`overallLevel`	`low`, `medium`, `high`, `very_high`	Aggregate risk level combining the phone and email scores.

Sample response

{
    "kyc": [
        { "key": "phoneLevel", "status": "low" },
        { "key": "phoneCarrier", "status": "Verizon" },
        { "key": "emailLevel", "status": "low" },
        { "key": "overallLevel", "status": "low" }
    ]
}