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.
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 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}]$. |
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}]$. |
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 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 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. |
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}]$. |
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}]$. |
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 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 abaixo |
receiverRelationship | Relação com o devedor | Obrigatório | ENUM | Consulte os valores válidos abaixo |
Os valores válidos de purposeCode dependem de o ordenante ser uma empresa ou uma pessoa física.
| 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 |
| 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 |
Os valores válidos de sourceOfCash dependem de o ordenante ser uma empresa ou uma pessoa física.
| 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 |
| 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 |
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.
| 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 |
| 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 |