Onboarding in Mexico

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