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.
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 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}]$. |
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]+$. |
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]+$. |
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 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 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]+$. |
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}]$. |
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. |
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]+$. |
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 abaixo |
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 dependem de o beneficiário ser uma empresa ou uma pessoa física |
| 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 | Manutenção 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ó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 |
Os valores válidos de receiverRelationship dependem de o beneficiário ser uma empresa ou uma pessoa física.
| 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 |
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.
| Código | Descrição |
|---|---|
CHIL | Filho(a) |
CUST | Cliente |
EMPL | Empregado |
EXSP | Ex-cônjuge |
FREN | Amigo(a) |
OTHR | Outros |
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 |
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.
| 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.
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.
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.
Ao enviar para o Kasikorn Bank, o país de origem do remetente não pode ser a Tailândia.
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 |