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

FieldRequiredType
CPFTRUEstring

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

FieldRequiredType
firstNametruestring
lastNametruestring
dateOfBirthtruedate
countrytruestring
countryCodetruestring
citytruestring
zipCodetruestring
addresstruestring
statetruestring
nationalitiestruearray
National ID Fronttruefile_upload
National ID Backtruefile_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.

FieldRequiredType
firstNametruestring
lastNametruestring
dateOfBirthtruedate
countrytruestring
citytruestring
zipCodetruestring
addresstruestring
nationalitiestruearray
National ID Fronttruefile_upload
National ID Backtruefile_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.

FieldRequiredType
firstNametruestring
lastNametruestring
dateOfBirthtruedate
countrytruestring
citytruestring
zipCodetruestring
addresstruestring
Statetruestring
DNItruestring
Type Document Coltruestring

Accepted document type in Colombia

Document TypeCodeDescriptionValid Format
Cédula de CiudadaníaCCCitizenship CardExactly 10 digits
Tarjeta de IdentidadTIIdentity Card6 to 10 digits
Registro CivilRCCivil Registry of Birth6 to 10 digits
Cédula de ExtranjeríaCEForeign Citizenship Card6 to 10 digits
PasaportePPPassport6 to 9 alphanumeric chars
Número de Identificación TributariaNITTax Identification Number9 to 12 digits
NIT ExtranjeroNEForeign NIT9 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 TypeSides
PassportFront
Any other ID cardFront and Back

Document size requirements

Document TypeSize Limit
ID Card / Passport5 MB
Address Proof / Bank Statements / Other Business Documents16 MB

Document format requirements

Document TypeSupported Formats
Document Frontpdf, jpg, png
Document Backpdf, jpg, png
Selfiejpg, png
Address Proof / Bank Statements / Other business Documentspdf, jpg, png