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 e Instrumentos financeiros, ou use o Utilitário de schema de payload.

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 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 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 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 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`	Manutenção familiar
`INVS`	Investimento e valores mobiliários
`OTHR`	Outros
`SUPP`	Pagamento a fornecedor