/api/partner/v2/kyc/send-verification

Headers

PartnerApiKey (string) - API key associated with the partner.

🚧

Partner API Key Required

Requires partner-api-key for authentication to ensure only authorized partners can access this data.

See 🔑 API Key Generation Guide for getting your API key

Body:

• userId (string) - The unique identifier of the user for whom the direct link is being generated.
• country (string) - The country code where the partner operates. Must be a valid value from SupportedCountry.
• personalInfo (object, optional) - Personal information of the user, required only for partners in Mexico (country = "MX").
  • profession (string) - The user's profession. Must be a valid value from SupportedUserProfessions.

  • 📘

    Possible values

    1. Employee
    2. Public Servant
    3. Entrepreneur or Contractor
    4. Student
    5. Other

  • phoneNumber (string) - The user's phone number in international format.
  • birthCountry (string) - The user's birth country code. Must be a valid ISO 3166-1 alpha-2 country code.
  • taxId (string) - The user taxId for Mexican users. This value is called RFC which complies with this format Link.

Example

{
  "userId": "2da954cd-2fda-49c2-ad77-6208c5ab71d6",
  "country": "MX",

  "personalInfo": {
    "profession": "Employee",
    "phoneNumber": "+524401234567",
    "birthCountry": "MX",
    "taxId": "LOZG7802117B9"
  }
}

Use cases

Regulatory Compliance in Mexico

A partner operating in Mexico needs to verify the identity of a new user to comply with local regulations. The request includes the userId, country set to MX, and the user's personal information such as profession, phoneNumber, and birthCountry.

Webhook Verification Response

After the user completes the KYC process using the link, a verification response will be sent to your system via a our webhook system specified in this our Webhook Guide.