Market specifications

Do you want to know more information about Thailand's market? Go to the Accelerate Growth in Asia’s Leading eCommerce Hubs article.

Country reference

`country` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.document.id` format
`TH`	`THB`	2	Thai Identity Card	13 digits

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	P2P
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`beneficiary.bank_account.code`	Yes	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes	Yes
`beneficiary.phone`	Yes	Yes	Yes
`remitter`	-	-	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.document.id`	-	-	Yes
`remitter.document.type`	-	-	Yes
`remitter.birth_info.date`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes
`remitter.nationality`	-	-	Yes

Wallet transfers

Wallet transfer parameters	B2C	B2B
`external_id`	Yes	Yes
`payment_method_id`	Yes	Yes
`flow_type`	Yes	Yes
`purpose`	Yes	Yes
`country`	Yes	Yes
`amount`	Yes	Yes
`currency`	Yes	Yes
`beneficiary.first_name`	Yes	-
`beneficiary.last_name`	Yes	-
`beneficiary.business_name`	-	Yes
`beneficiary.phone`	Yes	Yes
`beneficiary.instant_payment.id`	Yes	Yes
`beneficiary.instant_payment.type`	Yes	Yes

Payment methods

Thailand supports payouts via Bank transfers and Wallet transfers. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Use Wallet transfers for instant payments to mobile wallets. Use Bank transfers when sending funds directly to a bank account.

Bank transfers

Bank transfers in Thailand require detailed account information, including bank code, bank account number, amount, currency, and phone. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the bank codes section for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`external_id`	Unique transaction identifier. Maximum 100 characters.
`payment_method_id`	Payment method. For Thailand, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`amount`	Payout amount (in the currency set in the `currency` field). Use up to 2 decimal places.
`currency`	Payout currency. For Thailand, use `THB` or `USD`.
`country`	Country code. For Thailand, use `TH`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Only applies when the beneficiary is an individual. Maximum 50 characters.
`beneficiary.bank_account.code`	Beneficiary's bank account code. See bank codes below.
`beneficiary.bank_account.account`	Beneficiary's bank account number. Maximum 45 characters.
`beneficiary.bank_account.type`	Beneficiary's bank account type. Account type: `CHECKING`: Checking accounts `SAVINGS`: Savings accounts
`beneficiary.phone`	Beneficiary's phone number. Maximum 15 characters.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type: `ID` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter.birth_info.date`	Remitter's birthdate. Format: YYYY-MM-DD. Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's address street. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's address city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's address country. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's document. Maximum 45 characters. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "4G7X2B9QK",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "TH",
  "amount": 100,
  "currency": "THB",
  "notification_url": "http://google.com",
  "beneficiary": {
    "first_name": "Krit",
    "last_name": "Wongsuwan",
    "phone": "123456789123456",
    "bank_account": {
      "code": "3",
      "account": "1234567890",
      "type": "SAVINGS"
    }
  }
}

{
  "external_id": "P2P4G7X2B9QK",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "TH",
  "amount": 100,
  "currency": "THB",
  "notification_url": "http://google.com",
  "beneficiary": {
    "first_name": "Krit",
    "last_name": "Wongsuwan",
    "phone": "123456789123456",
    "bank_account": {
      "code": "3",
      "account": "1234567890",
      "type": "SAVINGS"
    }
  },
  "remitter": {
    "first_name": "John",
    "last_name": "Doe",
    "nationality": "US",
    "document": {
      "type": "PASS",
      "id": "AB12345678"
    },
    "birth_info": {
      "date": "1980-01-15"
    },
    "address": {
      "street": "123 Main Street",
      "city": "New York",
      "country": "US",
      "postal_code": "10001"
    }
  }
}

Wallet transfers

Wallet transfers enable real-time transfers using a mobile phone number linked to a wallet.

The beneficiary.instant_payment.type field must indicate the type of wallet being used (e.g., TrueMoney). The beneficiary.phone field must be present and correctly formatted, and the phone number should be provided in beneficiary.instant_payment.id as well.

Mandatory parameters

The table below outlines the required parameters for Wallet transfers.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For wallet transfers, use `INSTANT_PAYMENT`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`amount`	Payout amount (in the currency set in the `currency` field). Use up to 2 decimal places.
`country`	Country code. For Thailand, use `TH`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Only applies when the beneficiary is an individual. Maximum 50 characters.
`currency`	Payout currency. For Thailand, use `THB`.
`beneficiary.instant_payment.id`	Beneficiary's wallet ID. Maximum 45 characters.
`beneficiary.instant_payment.type`	Beneficiary's instant payment account type. Type of wallet being used: `TRUEMONEY`.

Example request

{
  "external_id": "68907654",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "TH",
  "amount": 100,
  "currency": "THB",
  "notification_url": "http://merchantsite.com/notifications",
  "beneficiary": {
    "first_name": "DLOCAL Thailand",
    "last_name": "Limited",
    "instant_payment": {
      "id": "8756435675",
      "type": "TRUEMONEY"
    }
  }
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Thailand.

Bank codes

Bank Name	Bank Code
Agriculture & Agricultural Coop	23
Bangkok Bank	1
Bank of America National Association	15
Bank of Ayudhya	2
CIMB Thai Bank Public Company Ltd	3
Citibank	11
Deutsche Bank	17
Government Housing Bank	24
Government Saving Bank	4
Hong Kong & Shanghai Corporation Limited	16
Industrial and Commercial Bank of China	26
Islamic Bank of Thailand	19
Kasikorn Bank	5
Kiatnakin Bank Public Company Limited	21
Krung Thai Bank	6
Land and Houses Bank Public Company Limited	25
Mega International Commercial Bank PCL	14
Mizuho Corporate Bank Limited	18
Siam Commercial Bank	7
Standard Chartered Bank (Thai)	13
Sumitomo Mitsui Banking Corporation	12
Thai Military Bank	8
Thanachart Bank	9
The Thai Credit Retail Bank Public Company Limited	22
Tisco Bank Public Company Limited	20
United Oversea Bank (Thai) Ltd	10