Onboarding in Mexico

Step-by-step guide to onboard Mexican users

Create a Customer

Begin by creating a customer and saving the customerId generated in the response.

{
    "email": "[email protected]",
    "type": "INDIVIDUAL"
}
{
    "customerId": "bd556075-da95-45d7-a006-bc1d3c0655a1",
    "createdAt": "2024-11-27T16:14:39.198Z"
}

Add KYC Info

Once you have created a customer, you can now add their KYC information. This will create a new KYC submissionId, which can be used to track their KYC status.

{
  "kycSubmission": {
    "firstName": "Alejandro",
    "lastName": "Mendoza",
    "dateOfBirth": "1986-10-03",
    "country": "MX",
    "city": "Ciudad de Méxicoo",
    "zipCode": "06890",
    "address": "Juan Hernández y Davalos No. 238 No. A",
    "state": "Cuauhtémoc",
    "nationalities": ["Mexican"],
    "phoneNumber": "+5511912345678",
    "occupation": "Developer"
    }
}
{
    "submissionId": "9ca806ef-74e5-48ae-a225-ac06f397db10",
    "createdAt": "2024-11-27T17:35:48.449Z",
    "firstName": "Alejandro",
    "lastName": "Mendoza",
    "dateOfBirth": "1986-10-03",
    "country": "MX",
    "city": "Ciudad de Méxicoo",
    "zipCode": "06890",
    "address": "Juan Hernández y Davalos No. 238 No. A",
    "state": "Cuauhtémoc",
    "nationalities": [
        "Mexican"
    ],
    "phoneNumber": "+5511912345678",
    "occupation": "Developer"
}

KYC Required Fields

The following is a list of all the kycRequiredFields needed to complete the KYC information. You can also use the List KYC Requirements endpoint to fetch this list using the API.

FieldRequiredType
firstNametruestring
lastNametruestring
dateOfBirthtruedate
countrytruestring
citytruestring
zipCodetruestring
addresstruestring
nationalitiestruearray
National ID Fronttruefile_upload
National ID Backtruefile_upload

Add KYC Files

Next, upload copies of the front and back of the customer's INE (Instituto Nacional Electoral) using the Add KYC Files endpoint. The customer may also submit their Resident Card (FM3/FM2). A utility bill is needed with this ID to prove the address.

Submit KYC

Once all of the required information and files have been uploaded, the next step is to Submit the KYC submission to be processed.

Complete KYC

In the Sandbox environment, you will need to call the Create Webhook endpoint to move the KYC into COMPLETEDstatus.

{
  "referenceId": "{{submissionId}}",
  "eventType": "KYC",
  "status": "COMPLETED",
  "metadata": null
}

Finally, the Customer KYC is complete. Now, it is time to add their payment method and begin transacting.