# Requisitos de Dados da Tailândia (THB)

Esta página lista todos os requisitos de dados para pagamentos em THB para a Tailândia: 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 `TH_PROMPTPAY`
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}]$`. |
| `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 | Um destes: `INCORPORATION_CERTIFICATE`, `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}]$`. |
| `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: `ALIEN_REGISTRATION`, `DRIVERS_LICENSE`, `EMPLOYEE_ID`, `NATIONAL_ID_NUMBER`, `PASSPORT`, `SSN`, `TAX_ID`. |
| `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: TH_PROMPTPAY` e `currency: THB`. Forneça os campos a seguir no objeto do payment rail `thPromptpay`. 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} .,'&\/()-]+(?<![ .,'&\/-])?$`. |
| `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 Tailândia para encontrar o código bancário. |
| `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]+$`. |


## 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}]$`. |
| `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 | Um destes: `INCORPORATION_CERTIFICATE`, `TAX_ID`. |
| `incorporationCountry` | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a `^[A-Z]+$`. |
| `incorporationDate` | Obrigatório | STRING | A data de constituição da empresa. Formato `date`. |


### 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}]$`. |
| `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 | Deve ser `PASSPORT`. |
| `identityDocuments[].expiryDate` | Obrigatório | STRING | Data de validade do documento de identificação. Formato `date`. |
| `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]+$`. |


## Requisitos de dados de transação

Os campos em nível de transação a seguir se aplicam a todos os pagamentos em THB à Tailândia via PromptPay.

| Campo  | Descrição  | Obrigatório | Tipo | Restrições  |
|  --- | --- | --- | --- | --- |
| `purposeCode` | Finalidade do pagamento | Obrigatório | ENUM | De 4 a 5 caracteres. Consulte os [valores válidos](#c%C3%B3digos-de-finalidade-do-pagamento) abaixo |
| `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; os valores válidos dependem de o beneficiário ser uma empresa ou uma pessoa física |


## Códigos de finalidade do pagamento

| Código | Descrição |
|  --- | --- |
| `ACSC` | Serviços contábeis |
| `AMSC` | Serviços de publicidade, pesquisa de mercado e pesquisa de opinião pública |
| `ALLW` | Auxílio |
| `GIFT` | Auxílio (doação) |
| `ENGS` | Serviços de arquitetura, engenharia e outros serviços técnicos |
| `BONU` | Pagamento de bônus |
| `COMM` | Comissão |
| `CISC` | Serviços de construção e instalação |
| `DEPT` | Depósito |
| `DOFI` | Depósitos em ou de instituições financeiras offshore |
| `EDUC` | Educação |
| `EDSC` | Serviços educacionais |
| `FAMI` | Sustento familiar |
| `GSST` | Bens e serviços de trabalhadores temporários |
| `GSTR` | Bens e serviços de viajantes |
| `GSPM` | Bens para processamento e serviços de manufatura |
| `HLTC` | Atendimento domiciliar de saúde |
| `INTE` | Juros |
| `INTC` | Pagamento intracompanhia |
| `INVS` | Investimento e valores mobiliários |
| `IVPT` | Pagamento de fatura |
| `LESC` | Serviços jurídicos |
| `MRSC` | Serviços de manutenção e reparo |
| `MDCS` | Serviços médicos |
| `MP2P` | Pagamento P2P móvel |
| `OTHR` | Outros |
| `PSFR` | Tarifa de passageiro |
| `MACH` | Pagamento de máquinas e equipamentos de transporte |
| `MFGD` | Pagamento de bens manufaturados |
| `MMFA` | Pagamento de artigos manufaturados diversos |
| `FEES` | Pagamento de tarifas |
| `PAYR` | Folha de pagamento |
| `GDDS` | Compra e venda de bens |
| `GDSV` | Compra e venda de bens e serviços |
| `SCVE` | Compra e venda de serviços |
| `REAB` | Imóveis no exterior |
| `RELG` | Aluguel geral |
| `SALA` | Pagamento de salário |
| `STDY` | Estudos |
| `SUPP` | Pagamento a fornecedor |
| `TRAD` | Serviços comerciais |
| `VIAC` | Taxas de solicitação de visto |


## Códigos de origem dos recursos

| Código | Descrição |
|  --- | --- |
| `ALMY` | Pensão alimentícia |
| `CASH` | Recursos em espécie |
| `COMP` | Remuneração |
| `EMIN` | Renda de empregado |
| `GIFT` | Doação |
| `INHE` | Herança |
| `INLQ` | Liquidação de prêmio de seguro |
| `PACA` | Capital integralizado |
| `REDM` | Resgate |
| `REPY` | Plano de previdência |
| `REST` | Venda de imóvel |
| `RETA` | Lucros retidos |
| `SALE` | Venda de bens |
| `SEAQ` | Venda ou aquisição de empresa |
| `SELF` | Renda de trabalho autônomo |
| `SVGS` | Poupança |
| `WINS` | Prêmios |


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

Os valores válidos de `receiverRelationship` dependem de o beneficiário ser uma empresa ou uma pessoa física.

### Beneficiários empresas

| Código | Descrição |
|  --- | --- |
| `BRAN` | Filial/escritório de representação |
| `CUST` | Cliente |
| `FRAN` | Franqueado/franqueador |
| `HOLD` | Holding |
| `PART` | Parceiro de negócios |
| `SUBS` | Empresa subsidiária |
| `SUPP` | Fornecedor |


Exceção de empresa para empresa
Nos pagamentos de empresa para empresa (casos de uso `B2B`, `B2B2B`), `CUST` não é um valor válido de `receiverRelationship`; apenas os outros seis códigos se aplicam.

### Beneficiários pessoas físicas

| Código | Descrição |
|  --- | --- |
| `CHIL` | Filho(a) |
| `CUST` | Cliente |
| `EMPL` | Empregado |
| `EXSP` | Ex-cônjuge |
| `FREN` | Amigo(a) |
| `OTHR` | Outro |
| `PARE` | Pai/Mãe |
| `PART` | Parceiro de negócios |
| `RELA` | Relação |
| `SELF` | O próprio |
| `SIBL` | Irmão/irmã |
| `SPOU` | Cônjuge/companheiro(a) |
| `VEND` | Fornecedor |


Exceção de empresa para pessoa física
Nos pagamentos de empresa para pessoa física e de pessoa física para pessoa física nos casos de uso `B2B2C` e `B2C`, `CUST` não é um valor válido de `receiverRelationship`; apenas os outros doze códigos se aplicam. `CUST` é válido para `C2B2C`.

## Limites de transação

| Tipo de limite | Valor (THB) |
|  --- | --- |
| Mínimo por transação | 65.00 |
| Máximo por transação | 500.000,00 |
| Limite diário de compliance por beneficiário | 1.750.000,00 |


As transações que levam o remetente ou o recebedor a ultrapassar o limite diário de compliance ficam retidas para análise de compliance.

## Requisitos de correspondência de nomes

Todas as transações para a Tailândia estão sujeitas a correspondência rigorosa de nomes. Os campos a seguir precisam estar corretos:

- Nome completo do remetente
- Data de nascimento do remetente
- Nome completo do beneficiário


Regras de correspondência de nomes:

- Pelo menos **85%** do nome do beneficiário precisa corresponder ao nome cadastrado no banco tailandês dele.
- Informe o nome completo exatamente como cadastrado: nome, nome do meio e sobrenome.
- Não inclua prefixos ou pronomes de tratamento (Mr, Ms, Mrs etc.).
- Evite nomes duplicados ou repetitivos.
- Informe o sobrenome no campo **Surname**; todas as demais partes do nome no campo **Nome**.
- Não informe "NO LAST NAME". Esses valores serão rejeitados.
- Remova quaisquer espaços extras antes ou depois do nome.


Risco de rejeição
Dados de nome incorretos resultam na rejeição da transação. Confira todos os campos de nome com o cadastro bancário do beneficiário antes de enviar.

## Restrição do Kasikorn Bank

Kasikorn Bank (código bancário 6600007)
Ao enviar para o Kasikorn Bank, o país de origem do remetente não pode ser a Tailândia.

## Tipos de documento de identidade aceitos

Os pagamentos via `TH_PROMPTPAY` aceitam apenas os seguintes tipos de documento de identidade. As requisições que usam um tipo de documento não listado para o papel de pagamento correspondente são rejeitadas com um erro 400. Quando um papel ou tipo de identidade não está listado abaixo, todos os valores do enum do campo são aceitos.

| Tipo de identidade | Papel de pagamento | Tipos de documento aceitos |
|  --- | --- | --- |
| Pessoa física (`idType`) | Ordenante | PASSPORT |
| Pessoa física (`idType`) | Beneficiário | ALIEN_REGISTRATION, DRIVERS_LICENSE, EMPLOYEE_ID, NATIONAL_ID_NUMBER, PASSPORT, SSN, TAX_ID |