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.
Field | Required | Type |
---|---|---|
firstName | true | string |
lastName | true | string |
dateOfBirth | true | date |
country | true | string |
city | true | string |
zipCode | true | string |
address | true | string |
nationalities | true | array |
National ID Front | true | file_upload |
National ID Back | true | file_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 COMPLETED
status.
{
"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.
Updated 4 days ago