# Requisitos de Dados do Peru (PEN)

Esta página lista todos os requisitos de dados para pagamentos em PEN para o Peru: as identidades
do beneficiário e do ordenante, o instrumento financeiro do beneficiário e a própria transação.

Os campos exibidos são os exigidos por este corredor
As tabelas de identidade e de instrumento financeiro nesta página listam apenas os campos que `PE_LBTR`
exige, extraídos do schema PII v3. Identidades e instrumentos financeiros aceitam outros campos
opcionais. Para o conjunto completo, consulte
[Identidades do pagamento](/pt-br/products/payments-direct-2/introduction/concepts/payment-identities) e
[Instrumentos financeiros](/pt-br/products/payments-direct-2/introduction/concepts/financial-instruments), ou use o
[Utilitário de schema de payload](/pt-br/products/payments-direct-2/api-docs/integration-resources/payload-schema-utility).

## Identidade do beneficiário

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](/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-identities)
para o fluxo da API.

Os campos obrigatórios dependem de o beneficiário ser uma **empresa** ou uma **pessoa física**.

### Beneficiário empresa

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]+$`. |


### Beneficiário pessoa física

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]+$`. |


## Instrumento financeiro do beneficiário

Defina `financialInstrumentType: PE_LBTR` e `currency: PEN`. Forneça os campos a seguir no objeto do payment rail `peLbtr`. Consulte [Criar e gerenciar instrumentos financeiros](/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-financial-instruments) 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](/pt-br/products/payments-direct-2/api-docs/integration-resources/ripple-bank-codes) e selecione Peru para encontrar o código SWIFT/BIC. |
| `accountNumber` | Obrigatório | STRING | O número da conta bancária da identidade. De 10 a 20 caracteres. Deve corresponder a `^[A-Za-z0-9]+$`. |
| `accountType` | Obrigatório | STRING | O tipo de conta da identidade. Um destes: `CHECKING`, `SAVINGS`. |


## Identidade do ordenante

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

### Ordenante empresa

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]+$`. |


### Ordenante pessoa física

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]+$`. |


## Requisitos de dados de transação

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](#c%C3%B3digos-de-finalidade-do-pagamento) abaixo. |


## Códigos de finalidade do pagamento

Envie um dos valores a seguir em `purposeCode`.

| Código | Descrição |
|  --- | --- |
| `COMP` | Pagamento de remuneração |
| `FAMI` | Sustento familiar |
| `INVS` | Investimento e valores mobiliários |
| `OTHR` | Outros |
| `SUPP` | Pagamento a fornecedor |