Esta página lista todos os requisitos de dados para pagamentos em CLP para o Chile: as identidades do beneficiário e do ordenante, o instrumento financeiro do beneficiário e a própria transação.
As tabelas de identidade e de instrumento financeiro nesta página listam apenas os campos que CL_TEF exige, extraídos do schema PII v3. Identidades e instrumentos financeiros aceitam outros campos opcionais. Para o conjunto completo, consulte Identidades do pagamento e Instrumentos financeiros, ou use o Utilitário de schema de payload.
Crie a identidade do beneficiário antes do instrumento financeiro e faça referência a ela ao criar o pagamento. Consulte Criar e gerenciar identidades para o fluxo da API.
Os campos obrigatórios dependem de o beneficiário ser uma empresa ou uma pessoa física.
Aplica-se aos casos de uso B2B, B2B2B e C2B2B. Envie uma identidade business.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
businessName | Obrigatório | STRING | Razão social. De 1 a 140 caracteres. Deve corresponder a ^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$. |
address.streetAddress | Obrigatório | ARRAY de STRING | Permite armazenar o endereço da empresa. |
address.country | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
address.city | Obrigatório | STRING | Cidade. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$. |
address.stateOrProvince | Obrigatório | STRING | Estado, província ou condado do endereço da empresa, conforme definido pelos serviços postais. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$. |
address.postalCode | Obrigatório | STRING | Código postal da empresa. De 3 a 15 caracteres. Deve corresponder a ^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$. |
email | Obrigatório | STRING | Endereço de correio eletrônico (e-mail). De 6 a 255 caracteres. Formato email. Deve corresponder a ^(?=.{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 | Obrigatório | STRING | Número de telefone. De 8 a 16 caracteres. Deve corresponder a ^\+[1-9]\d+$. |
registration[].number | Obrigatório | STRING | O identificador exclusivo da organização. De 3 a 35 caracteres. Deve corresponder a ^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$. |
registration[].type | Obrigatório | STRING | Deve ser TAX_ID. |
incorporationCountry | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
Aplica-se aos casos de uso B2B2C, B2C e C2B2C. Envie uma identidade individual.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
firstName | Obrigatório | STRING | Nome da pessoa física. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$. |
lastName | Obrigatório | STRING | Sobrenome da pessoa física. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$. |
address.streetAddress | Obrigatório | ARRAY de STRING | Permite armazenar o endereço da pessoa física. |
address.country | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
address.city | Obrigatório | STRING | Cidade. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$. |
address.stateOrProvince | Obrigatório | STRING | Estado, província ou condado do endereço da pessoa física, conforme definido pelos serviços postais. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$. |
address.postalCode | Obrigatório | STRING | Código postal do endereço da pessoa física. De 3 a 15 caracteres. Deve corresponder a ^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$. |
email | Obrigatório | STRING | Endereço de correio eletrônico (e-mail). De 6 a 255 caracteres. Formato email. Deve corresponder a ^(?=.{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 | Obrigatório | STRING | Número de telefone. De 8 a 16 caracteres. Deve corresponder a ^\+[1-9]\d+$. |
identityDocuments[].idNumber | Obrigatório | STRING | Número de identificação. De 3 a 35 caracteres. Deve corresponder a ^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$. |
identityDocuments[].idType | Obrigatório | STRING | Um destes: NATIONAL_ID_NUMBER, TAX_ID. |
dateOfBirth | Obrigatório | STRING | Data de nascimento. Formato date. |
citizenship | Obrigatório | STRING | Código de país alfa-2 da nacionalidade da pessoa física no formato ISO 3166-1. Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
Defina financialInstrumentType: CL_TEF e currency: CLP. Forneça os campos a seguir no objeto do payment rail clTef. Consulte Criar e gerenciar instrumentos financeiros para o fluxo da API.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
bankName | Obrigatório | STRING | O nome do banco da identidade. De 2 a 140 caracteres. Deve corresponder a ^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$. |
swiftCode | Obrigatório | STRING | Código SWIFT/BIC do banco da identidade. De 8 a 11 caracteres. Deve corresponder a ^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$. Use a consulta Códigos bancários e selecione Chile para encontrar o código SWIFT/BIC. |
accountNumber | Obrigatório | STRING | O número da conta bancária da identidade. De 6 a 34 caracteres. Deve corresponder a ^[A-Za-z0-9]+$. |
accountType | Obrigatório | STRING | O tipo de conta da identidade. Um destes: CHECKING, SAVINGS. |
Crie a identidade do ordenante uma vez e reutilize-a em todos os pagamentos.
Os campos obrigatórios dependem de o ordenante ser uma empresa ou uma pessoa física.
Aplica-se aos casos de uso B2B, B2B2B, B2B2C e B2C. Envie uma identidade business.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
businessName | Obrigatório | STRING | Razão social. De 1 a 140 caracteres. Deve corresponder a ^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$. |
address.streetAddress | Obrigatório | ARRAY de STRING | Permite armazenar o endereço da empresa. |
address.country | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
address.city | Obrigatório | STRING | Cidade. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$. |
address.stateOrProvince | Obrigatório | STRING | Estado, província ou condado do endereço da empresa, conforme definido pelos serviços postais. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$. |
address.postalCode | Obrigatório | STRING | Código postal da empresa. De 3 a 15 caracteres. Deve corresponder a ^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$. |
email | Obrigatório | STRING | Endereço de correio eletrônico (e-mail). De 6 a 255 caracteres. Formato email. Deve corresponder a ^(?=.{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 | Obrigatório | STRING | Número de telefone. De 8 a 16 caracteres. Deve corresponder a ^\+[1-9]\d+$. |
registration[].number | Obrigatório | STRING | O identificador exclusivo da organização. De 3 a 35 caracteres. Deve corresponder a ^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$. |
registration[].type | Obrigatório | STRING | Deve ser TAX_ID. |
incorporationCountry | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
Aplica-se aos casos de uso C2B2B e C2B2C. Envie uma identidade individual.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
firstName | Obrigatório | STRING | Nome da pessoa física. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$. |
lastName | Obrigatório | STRING | Sobrenome da pessoa física. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$. |
address.streetAddress | Obrigatório | ARRAY de STRING | Permite armazenar o endereço da pessoa física. |
address.country | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
address.city | Obrigatório | STRING | Cidade. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$. |
address.stateOrProvince | Obrigatório | STRING | Estado, província ou condado do endereço da pessoa física, conforme definido pelos serviços postais. De 1 a 140 caracteres. Deve corresponder a ^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$. |
address.postalCode | Obrigatório | STRING | Código postal do endereço da pessoa física. De 3 a 15 caracteres. Deve corresponder a ^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$. |
email | Obrigatório | STRING | Endereço de correio eletrônico (e-mail). De 6 a 255 caracteres. Formato email. Deve corresponder a ^(?=.{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 | Obrigatório | STRING | Número de telefone. De 8 a 16 caracteres. Deve corresponder a ^\+[1-9]\d+$. |
identityDocuments[].idNumber | Obrigatório | STRING | Número de identificação. De 3 a 35 caracteres. Deve corresponder a ^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$. |
identityDocuments[].idType | Obrigatório | STRING | Um destes: PASSPORT, TAX_ID. |
dateOfBirth | Obrigatório | STRING | Data de nascimento. Formato date. |
countryOfBirth | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
citizenship | Obrigatório | STRING | Código de país alfa-2 da nacionalidade da pessoa física no formato ISO 3166-1. Exatamente 2 caracteres. Deve corresponder a ^[A-Z]+$. |
Os dados do beneficiário e do ordenante vêm das identidades que você cria previamente, e os dados bancários vêm do instrumento financeiro. O único campo que você define no próprio pagamento para este corredor está abaixo.
| Campo | Descrição | Obrigatório | Tipo | Restrições |
|---|---|---|---|---|
purposeCode | Finalidade do pagamento | Obrigatório | ENUM | Máximo de 4 caracteres. Consulte os valores válidos abaixo. |
Envie um dos valores a seguir em purposeCode.
| Código | Descrição |
|---|---|
COMP | Pagamento de remuneração |
FAMI | Manutenção familiar |
INVS | Investimento e valores mobiliários |
OTHR | Outros |
SUPP | Pagamento a fornecedor |