# Requisitos de Dados do Japão (JPY)

Esta página lista todos os requisitos de dados para pagamentos em JPY para o Japão: 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 `JP_ZENGIN`
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}]$`. |


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


## Instrumento financeiro do beneficiário

Defina `financialInstrumentType: JP_ZENGIN` e `currency: JPY`. Forneça os campos a seguir no objeto do payment rail `jpZengin`. 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} .,'&\/()-]+(?<![ .,'&\/-])?$`. |
| `accountHolderName` | Obrigatório | STRING | Nome do titular da conta em caracteres katakana japoneses. De 1 a 100 caracteres. Deve corresponder a `^[\p{L}\p{N} .,'&\/()-]+$`. |
| `bankCode` | Obrigatório | STRING | De 1 a 16 caracteres. Deve corresponder a `^[A-Za-z0-9]+$`. Use a consulta [Códigos bancários](/pt-br/products/payments-direct-2/api-docs/integration-resources/ripple-bank-codes) e selecione Japão para encontrar o código bancário. |
| `branchCode` | Obrigatório | STRING | Código de agência atribuído pelo banco que identifica a agência específica. De 1 a 50 caracteres. Deve corresponder a `^[A-Za-z0-9]+$`. |
| `accountNumber` | Obrigatório | STRING | O número da conta bancária da identidade. De 1 a 45 caracteres. Deve corresponder a `^[A-Za-z0-9]+$`. |
| `accountType` | Obrigatório | STRING | O tipo de conta da identidade. Um destes: `CHECKING`, `ORDINARY`, `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}]$`. |


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


## Requisitos de dados de transação

Os campos em nível de transação a seguir se aplicam a todos os pagamentos em JPY ao Japão via Zengin.

| Campo  | Descrição  | Obrigatório | Tipo | Restrições  |
|  --- | --- | --- | --- | --- |
| `purposeCode` | Finalidade do pagamento | Obrigatório | ENUM | Consulte os [valores válidos](#c%C3%B3digos-de-finalidade-do-pagamento) abaixo |
| `paymentMemo` | Observações sobre a finalidade do pagamento | Obrigatório | STRING | Máximo de 100 caracteres. Obrigatório para compliance; não é encaminhado ao beneficiário. |
| `sourceOfCash` | Origem dos recursos | Obrigatório | ENUM | Consulte os [valores válidos](#c%C3%B3digos-de-origem-dos-recursos) abaixo |
| `receiverRelationship` | Relação com o devedor | Obrigatório | ENUM | Consulte os [valores válidos](#c%C3%B3digos-de-rela%C3%A7%C3%A3o-com-o-benefici%C3%A1rio) abaixo |


## Códigos de finalidade do pagamento

Os valores válidos de `purposeCode` dependem de o ordenante ser uma empresa ou uma pessoa física.

### De empresa para empresa e de empresa para pessoa física (B2B, B2B2B, B2B2C, B2C)

| Código | Descrição |
|  --- | --- |
| `ACCT` | Gestão de conta |
| `BEXP` | Despesas empresariais |
| `CASH` | Transferência de gestão de caixa |
| `CISC` | Construção |
| `CMDT` | Transferência de mercadorias |
| `COMM` | Comissão |
| `GDDS` | Compra ou venda de bens |
| `HLTC` | Assistência à saúde |
| `INSU` | Seguro |
| `INVS` | Investimento e valores mobiliários |
| `IPDO` | Doação |
| `LOAN` | Empréstimo |
| `OTHR` | Outro |
| `PSFR` | Viagem |
| `REAB` | Imóveis |
| `RENT` | Aluguel |
| `SALA` | Pagamento de salário |
| `SCTS` | Compra ou venda de serviços, tradução |
| `STDY` | Despesas de pesquisa |
| `TAXS` | Pagamento de tributos |
| `TRAD` | Serviços comerciais |


### De pessoa física para empresa e de pessoa física para pessoa física (C2B2B, C2B2C)

| Código | Descrição |
|  --- | --- |
| `ACCT` | Gestão de conta |
| `CHAR` | Pagamento a instituição de caridade |
| `CMDT` | Transferência de mercadorias |
| `COMM` | Comissão |
| `COST` | Despesa de subsistência |
| `EDUC` | Educação |
| `FAMI` | Apoio familiar |
| `GDDS` | Compra ou venda de bens |
| `GIFT` | Doação |
| `HLTC` | Assistência à saúde |
| `INSU` | Seguro |
| `INVS` | Investimento e valores mobiliários |
| `IPDO` | Doação |
| `LOAN` | Empréstimo |
| `OTHR` | Outro |
| `PENS` | Aposentadoria |
| `PSFR` | Viagem |
| `REAB` | Imóveis |
| `RENT` | Aluguel |
| `SALA` | Pagamento de salário |
| `SCTS` | Compra ou venda de serviço de tradução |
| `STDY` | Despesas de pesquisa |
| `TAXS` | Pagamento de tributos |


## Códigos de origem dos recursos

Os valores válidos de `sourceOfCash` dependem de o ordenante ser uma empresa ou uma pessoa física.

### De empresa para empresa e de empresa para pessoa física (B2B, B2B2B, B2B2C, B2C)

| Código | Descrição |
|  --- | --- |
| `CASH` | Liberação de empréstimo |
| `COMP` | Renda de aluguel |
| `REST` | Venda de imóvel |
| `RETA` | Lucro da empresa |
| `SEAQ` | Venda de empresa |
| `SVGS` | Investimento |


### De pessoa física para empresa e de pessoa física para pessoa física (C2B2B, C2B2C)

| Código | Descrição |
|  --- | --- |
| `CASH` | Liberação de empréstimo |
| `COMP` | Renda de aluguel |
| `EMIN` | Renda do trabalho |
| `GIFT` | Doação |
| `REST` | Venda de imóvel |
| `SEAQ` | Venda de empresa |
| `SELF` | Renda de trabalho autônomo |
| `SVGS` | Investimento |


## Códigos de relação com o beneficiário

Os valores válidos de `receiverRelationship` dependem de o ordenante ser uma empresa ou uma pessoa física. Eles não dependem do tipo de beneficiário.

### De empresa para empresa e de empresa para pessoa física (B2B, B2B2B, B2B2C, B2C)

| Código | Descrição |
|  --- | --- |
| `CUST` | Cliente |
| `EMPL` | Empregado |
| `FRAN` | Empresa de investimento |
| `HOLD` | Holding |
| `LEND` | Credor |
| `OTHR` | Consultor |
| `PART` | Prestador de serviços contratado |
| `SUPP` | Fornecedor de bens |
| `VEND` | Prestador de serviços |


### De pessoa física para empresa e de pessoa física para pessoa física (C2B2B, C2B2C)

| Código | Descrição |
|  --- | --- |
| `CHIL` | Filho(a) |
| `FREN` | Amigo(a) |
| `OTHR` | Outro |
| `PARE` | Pai/Mãe |
| `PART` | Parceiro de negócios |
| `SELF` | O próprio |
| `SIBL` | Irmão/irmã |
| `SPOU` | Cônjuge ou companheiro(a) |
| `SUPP` | Fornecedor |
| `VEND` | Prestador de serviços |