Onboarding Requirements by Country
Account information required by Country in order to transact in the alfred ecosystem.
Brazil
PIX is a payment method developed by the Central Bank of Brazil that enables transactions to occur in a couple seconds. Customers receive a PIX string or QR code that contains the amount to pay for services or goods to complete transactions. Customers then pay the PIX, before its expiration date, using their bank apps or internet banking. You’ll receive payment confirmation as soon as the PIX is paid.
Specific document required in Brazil (BRA): CPF
The Individual Taxpayer Registration (CPF) is the registry maintained by the Federal Revenue of Brazil, where any person must register once, regardless of age or nationality. Each registered person is identified in the country by a unique 11-digit number.
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.
Brazil KYC Required Fields
Field | Required | Type |
---|---|---|
CPF | TRUE | string |
Argentina
CBU (Uniform Bank Code) is a unique identification code, made up of 22 digits, for each bank account. The code provides account information: type, number, the bank it belongs to, and the branch. An alias can be assigned to ease the need of providing the full 22-digit code, instead they can indicate an alias previously assigned to the account.
CVU (Uniform Virtual Key) a unique identification code, made up of 22 digits as well, with a function to facilitate the operation between users of payment service providers (electronic wallets, prepaid cards, etc) and the financial system. It is composed of a first block (from digit 1 to 8), which identifies the PSP (payment service providor) to which it belongs, and the second block (from digit 9 to 22) identifies the user. Like the CBU, CVU holders can generate an alphanumeric CVU alias to streamline financial transactions.
Specific document required in Argentina (ARG): CUIT
The CUIT (Unique Tax Identification Key) is a code with which the AFIP identifies self-employed workers, businesses and companies. Any individual that initiates an economic activity must register with various government agencies, including the AFIP. Upon registration, a CUIT is granted by AFIP; thus, he/she acquires a tax identity via third parties, and is therefore entitled to develop its activities on a legal basis.
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.
Argentina KYC Required Fields
Field | Required | Type |
---|---|---|
firstName | true | string |
lastName | true | string |
dateOfBirth | true | date |
country | true | string |
countryCode | true | string |
city | true | string |
zipCode | true | string |
address | true | string |
state | true | string |
nationalities | true | array |
National ID Front | true | file_upload |
National ID Back | true | file_upload |
Mexico
CLABE is a unique 18-digit identifier for every bank account in Mexico. CLABE is short for Clave Bancaria Estandarizada which is the Spanish term for standard bank code. The first 6 digits represent the bank and branch, the following 11 digits represent the account number, and the final is a control digit that is used to validate the entire code.
Specific document required in Mexico (MEX): INE or CURP
An INE (Instituto Nacional Electoral) Card can be translated as the National Electoral Institute Card, this document is an official form of identification in Mexico. It contains an individuals up to date address, name, and other other important data points in order to safely process transactions.
The National ID Number (CURP) is an 18-character alphanumeric code. The CURP is an ID number provided by the Mexican government to Mexican citizens and residents. This can also be an acceptable form of identification in Mexico.
Mexico 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 |
Colombia
Specific document required in Colombia (COL): Cédula de Ciudadanía or CE
The Cédula de Ciudadanía (CC) is the national ID card issued to Colombian citizens over the age of 18. It is the most widely accepted form of identification in Colombia and includes the individual’s full name, ID number, and biometric data. Newer versions may also feature a QR code or barcode for secure digital verification.
For foreign nationals, the Cédula de Extranjería (CE) serves as the official form of identification and includes personal and residency details.
In some cases, a Tax Identification Number (NIT) may be required for financial or administrative processes.
Colombia 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 |
State | true | string |
DNI | true | string |
Type Document Col | true | string |
Accepted document type in Colombia
Document Type | Code | Description | Valid Format |
---|---|---|---|
Cédula de Ciudadanía | CC | Citizenship Card | Exactly 10 digits |
Tarjeta de Identidad | TI | Identity Card | 6 to 10 digits |
Registro Civil | RC | Civil Registry of Birth | 6 to 10 digits |
Cédula de Extranjería | CE | Foreign Citizenship Card | 6 to 10 digits |
Pasaporte | PP | Passport | 6 to 9 alphanumeric chars |
Número de Identificación Tributaria | NIT | Tax Identification Number | 9 to 12 digits |
NIT Extranjero | NE | Foreign NIT | 9 to 12 digits |
USA
This is only available through iframe.
SDK URL generation: Alfred generates an SDK URL that must be displayed on the front end. The SDK URL is valid for 24 hours. After that time, a new URL with a new token is generated for the user. Alfred handles the entire verification process. Users are asked to accept the Terms and Conditions. Identity data and documents are verified as shown in the interface.

The verification process takes up to 1 minute.
Verification via Webhook
Once Alfred completes the verification, the system receives the information via webhook to check the user’s status (accepted or rejected). You can also make a query to retrieve the current verification status.
HK/China
Add KYC Files and File Requirements (Argentina/Mexico/HK-China Only)
Once you have created a customer, you can now add their KYC Files sending their Front and Back of ID when applicable. The file type "National ID Front" or "National ID Back" is required to be sent along with the file.
Example request
curl --location --globoff '{{URL_BASE}}/customers/{{customerId}}/kyc/{{submissionId}}/files' \
--header 'api-key: {{apiKey}}' \
--header 'api-secret: {{apiSecret}}' \
--form 'fileType="National ID Front"' \
--form 'fileBody=@"/Users/alfred/Desktop/Alfred Pay/Argentina-Driver-License-psd.jpg
curl --location --globoff '{{URL_BASE}}/customers/{{customerId}}/kyc/{{submissionId}}/files' \
--header 'api-key: {{apiKey}}' \
--header 'api-secret: {{apiSecret}}' \
--form 'fileType="National ID Back"' \
--form 'fileBody=@"/Users/alfred/Desktop/Alfred Pay/Argentina-Driver-License-Back-psd.jpg
curl --location --globoff '{{URL_BASE}}/customers/{{customerId}}/kyc/{{submissionId}}/files' \
--header 'api-key: {{apiKey}}' \
--header 'api-secret: {{apiSecret}}' \
--form 'fileType="National ID Front"' \
--form 'fileBody=Passport
{
"message": "success"
}
Document side requirements:
Document Type | Sides |
---|---|
Passport | Front |
Any other ID card | Front and Back |
Document size requirements
Document Type | Size Limit |
---|---|
ID Card / Passport | 5 MB |
Address Proof / Bank Statements / Other Business Documents | 16 MB |
Document format requirements
Document Type | Supported Formats |
---|---|
Document Front | pdf, jpg, png |
Document Back | pdf, jpg, png |
Selfie | jpg, png |
Address Proof / Bank Statements / Other business Documents | pdf, jpg, png |
Updated 1 day ago