This page lists every data requirement for CLP payments to Chile: the beneficiary and originator identities, the beneficiary financial instrument, and the transaction itself.
Fields shown are those required for this corridor
The identity and financial instrument tables on this page list only the fields CL_TEF requires, taken from the PII v3 schema. Identities and financial instruments accept further optional fields. For the complete set, see Payment identities and Financial instruments, or use the Payload Schema Utility.
Create the beneficiary identity before the financial instrument, then reference it when you create the payment. See Create and manage identities for the API workflow.
The required fields depend on whether the beneficiary is a business or an individual.
Applies to the B2B, B2B2B, C2B2B use cases. Submit a business identity.
| Field | Required | Type | Constraints |
|---|---|---|---|
businessName | Required | STRING | Business Legal Name. 1–140 characters. Must match ^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$. |
address.streetAddress | Required | ARRAY of STRING | Allows the street address of the business to be held. |
address.country | Required | STRING | Exactly 2 characters. Must match ^[A-Z]+$. |
address.city | Required | STRING | City. 1–140 characters. Must match ^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$. |
address.stateOrProvince | Required | STRING | State, province, or county of the business address, as defined by postal services. 1–140 characters. Must match ^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$. |
address.postalCode | Required | STRING | Postal code for the business. 3–15 characters. Must match ^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$. |
email | Required | STRING | Address for electronic mail (e-mail). 6–255 characters. Format email. Must match ^(?=.{1,254}$)(?:[\p{L}\p{N}%+_-]+(?:\.[\p{L}\p{N}%+_-]+)*)@(?:(?:[\p{L}\p{N}](?:[\p{L}\p{N}-]{0,61}[\p{L}\p{N}])?)\.)+[\p{L}]{2,63}$. |
phone | Required | STRING | Phone Number. 8–16 characters. Must match ^\+[1-9]\d+$. |
registration[].number | Required | STRING | The unique identifier of the organization. 3–35 characters. Must match ^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$. |
registration[].type | Required | STRING | Must be TAX_ID. |
incorporationCountry | Required | STRING | Exactly 2 characters. Must match ^[A-Z]+$. |
Applies to the B2B2C, B2C, C2B2C use cases. Submit an individual identity.
| Field | Required | Type | Constraints |
|---|---|---|---|
firstName | Required | STRING | First name of the individual. 1–140 characters. Must match ^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$. |
lastName | Required | STRING | Last name of the individual. 1–140 characters. Must match ^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$. |
address.streetAddress | Required | ARRAY of STRING | Allows the street address of the individual to be held. |
address.country | Required | STRING | Exactly 2 characters. Must match ^[A-Z]+$. |
address.city | Required | STRING | City. 1–140 characters. Must match ^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$. |
address.stateOrProvince | Required | STRING | State, province, or county of the individual's address, as defined by postal services. 1–140 characters. Must match ^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$. |
address.postalCode | Required | STRING | Postal code for the individual's address. 3–15 characters. Must match ^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$. |
email | Required | STRING | Address for electronic mail (e-mail). 6–255 characters. Format email. Must match ^(?=.{1,254}$)(?:[\p{L}\p{N}%+_-]+(?:\.[\p{L}\p{N}%+_-]+)*)@(?:(?:[\p{L}\p{N}](?:[\p{L}\p{N}-]{0,61}[\p{L}\p{N}])?)\.)+[\p{L}]{2,63}$. |
phone | Required | STRING | Phone Number. 8–16 characters. Must match ^\+[1-9]\d+$. |
identityDocuments[].idNumber | Required | STRING | Identification Number. 3–35 characters. Must match ^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$. |
identityDocuments[].idType | Required | STRING | One of NATIONAL_ID_NUMBER, TAX_ID. |
dateOfBirth | Required | STRING | Date of Birth. Format date. |
citizenship | Required | STRING | Alpha-2 country code for the nationality of the individual in ISO 3166-1 format. Exactly 2 characters. Must match ^[A-Z]+$. |
Set financialInstrumentType: CL_TEF and currency: CLP. Provide the following fields in the clTef payment rail object. See Create and manage financial instruments for the API workflow.
| Field | Required | Type | Constraints |
|---|---|---|---|
bankName | Required | STRING | The name of the identity's bank. 2–140 characters. Must match ^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$. |
swiftCode | Required | STRING | SWIFT/BIC code of the identity's bank. 8–11 characters. Must match ^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$. Use the Bank Codes lookup and select Chile to find the SWIFT/BIC code. |
accountNumber | Required | STRING | The identity's bank account number. 6–34 characters. Must match ^[A-Za-z0-9]+$. |
accountType | Required | STRING | The identity's account type. One of CHECKING, SAVINGS. |
Create the originator identity once and reuse it across payments.
The required fields depend on whether the originator is a business or an individual.
Applies to the B2B, B2B2B, B2B2C, B2C use cases. Submit a business identity.
| Field | Required | Type | Constraints |
|---|---|---|---|
businessName | Required | STRING | Business Legal Name. 1–140 characters. Must match ^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$. |
address.streetAddress | Required | ARRAY of STRING | Allows the street address of the business to be held. |
address.country | Required | STRING | Exactly 2 characters. Must match ^[A-Z]+$. |
address.city | Required | STRING | City. 1–140 characters. Must match ^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$. |
address.stateOrProvince | Required | STRING | State, province, or county of the business address, as defined by postal services. 1–140 characters. Must match ^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$. |
address.postalCode | Required | STRING | Postal code for the business. 3–15 characters. Must match ^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$. |
email | Required | STRING | Address for electronic mail (e-mail). 6–255 characters. Format email. Must match ^(?=.{1,254}$)(?:[\p{L}\p{N}%+_-]+(?:\.[\p{L}\p{N}%+_-]+)*)@(?:(?:[\p{L}\p{N}](?:[\p{L}\p{N}-]{0,61}[\p{L}\p{N}])?)\.)+[\p{L}]{2,63}$. |
phone | Required | STRING | Phone Number. 8–16 characters. Must match ^\+[1-9]\d+$. |
registration[].number | Required | STRING | The unique identifier of the organization. 3–35 characters. Must match ^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$. |
registration[].type | Required | STRING | Must be TAX_ID. |
incorporationCountry | Required | STRING | Exactly 2 characters. Must match ^[A-Z]+$. |
Applies to the C2B2B, C2B2C use cases. Submit an individual identity.
| Field | Required | Type | Constraints |
|---|---|---|---|
firstName | Required | STRING | First name of the individual. 1–140 characters. Must match ^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$. |
lastName | Required | STRING | Last name of the individual. 1–140 characters. Must match ^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$. |
address.streetAddress | Required | ARRAY of STRING | Allows the street address of the individual to be held. |
address.country | Required | STRING | Exactly 2 characters. Must match ^[A-Z]+$. |
address.city | Required | STRING | City. 1–140 characters. Must match ^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$. |
address.stateOrProvince | Required | STRING | State, province, or county of the individual's address, as defined by postal services. 1–140 characters. Must match ^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$. |
address.postalCode | Required | STRING | Postal code for the individual's address. 3–15 characters. Must match ^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$. |
email | Required | STRING | Address for electronic mail (e-mail). 6–255 characters. Format email. Must match ^(?=.{1,254}$)(?:[\p{L}\p{N}%+_-]+(?:\.[\p{L}\p{N}%+_-]+)*)@(?:(?:[\p{L}\p{N}](?:[\p{L}\p{N}-]{0,61}[\p{L}\p{N}])?)\.)+[\p{L}]{2,63}$. |
phone | Required | STRING | Phone Number. 8–16 characters. Must match ^\+[1-9]\d+$. |
identityDocuments[].idNumber | Required | STRING | Identification Number. 3–35 characters. Must match ^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$. |
identityDocuments[].idType | Required | STRING | One of PASSPORT, TAX_ID. |
dateOfBirth | Required | STRING | Date of Birth. Format date. |
countryOfBirth | Required | STRING | Exactly 2 characters. Must match ^[A-Z]+$. |
citizenship | Required | STRING | Alpha-2 country code for the nationality of the individual in ISO 3166-1 format. Exactly 2 characters. Must match ^[A-Z]+$. |
The beneficiary and originator details come from the identities you create beforehand, and the bank details from the financial instrument. The only field you set on the payment itself for this corridor is below.
| Field | Description | Required | Type | Constraints |
|---|---|---|---|---|
purposeCode | Purpose of payment | Required | ENUM | Up to 4 characters. See valid values below. |
Send one of the following in purposeCode.
| Code | Description |
|---|---|
COMP | Compensation Payment |
FAMI | Family Maintenance |
INVS | Investment & Securities |
OTHR | Others |
SUPP | Supplier Payment |