Banks of Thailand (legacy)

Banks of Thailand — payment system that uses the banking mechanism for payments and payouts in Thailand. Payments are processed by using Payment Page, payouts are processed by using Gate.

Note:

A new technical implementation is available for working with the Banks of Thailand method. It is described in the Banks of Thailand section.

For the information on how to switch to a new implementation refer to your key account manager.

Purchases by using Payment Page

Processing of payments in this system can be performed only by using the Thai baht (THB). The minimal payout amount is 500.00 THB, the maximum amount is 500,000.00 THB. Payment processing is supported by banks, the list of them is provided in the table below.

Table 1. List of supported banks, purchases
Bank name Bank ID
Karsikorn Bank (K-Bank) 123
Bangkok Bank 124
Siam Commercial Bank 125
Krung Thai Bank 126
Bank of Ayudhya (Krungsri) 127
Government Savings Bank 128
TMB Bank Public Company Limited 129
Using preselected payment method

You can customize the selecting payment method page on Payment Page.

By default, banks that support Banks of Thailand payment method are grouped in one button on Payment Page, so the selection of a bank is carried out in two steps. First, the Banks of Thailand method is chosen among others, and then a particular bank is selected on the next page with the list of the group banks. There are several options for displaying the page with the selecting of payment method on Payment Page:

  • To display each bank of the Banks of Thailand group with a separate buttons, pass split_banks=true in the request for opening in the payment_methods_options string.
    payment_methods_options: {"thb_asian_banks": {"split_banks": true}}
    
  • To display a button of a specific bank (one or several) from Banks of Thailand group on Payment Page in the list of payment methods, pass the bank identifier in the banks_id parameter. If it is necessary to display several banks from a group, pass the identifiers of these banks separated by a comma with a space.
    payment_methods_options: {"thb_asian_banks": {"split_banks": true, "banks_id": [124, 126]}}
  • To preselect Banks of Thailand as the payment method on Payment Page for customers, pass the code thb_asian_banks in the force_payment_method parameter in the request for opening. The list of the banks from Banks of Thailand group is displayed to a customer on Payment Page bypassing the page with the payment method selection.
  • To immediately redirect a customer to the website of the specific bank from the Banks of Thailand group, pass the code thb_asian_banks in the force_payment_method parameter and the bank identifier banks_id in the payment_methods_options string. The customer is redirected to the bank website without confirming willingness to pay, bypassing the pages with the payment method selection and the choice of banks on Payment Page.

Figure: Example of the request for redirecting customer to the bank website

EPayWidget.run(
    { payment_id: 'X03936', 
      payment_amount: 10000, 
      payment_currency: 'THB', 
      project_id: 0,
      customer_id: 'user123',
      force_payment_method: 'thb_asian_banks',
      payment_methods_options: {"thb_asian_banks": {"banks_id": [125]}},
      signature: "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y1Y4HASCQ9vySO\/R...=="
    }
)

Payouts by using Gate

Processing of payouts in this system can be performed only by using the Thai baht (THB). The minimal payout amount is 500.00 THB, the maximum amount is 500,000.00 THB. The list of banks that support payout processing is provided in the table below.

Table 2. List of supported banks, payouts
Bank name Bank ID
KasiKorn Bank 123
Bangkok Bank 124
Siam Bank 125
Bank Of Ayudhya 127
Government Savings Bank 128
TMB Bank Public Company Limited 129
KTB Net Bank 164
Request for payout
Note: POST the /v2/payment/asian-banks/payout request.

In the request specify the unique payment ID in your system, as well as the ID of the bank in which the payment is made.

After Gate finishes processing your request you receive a callback with the result of payment request.

Figure: Example of request for payout

 {
            "general": {
                "project_id": 0,
                "payment_id": "Payout12",
                "signature": "8+oTRZBlWqIEXZxI+8QhvhPBquE/bFSgv7BpTJMl6gmZnEHT...=="
            },
            "customer": {
                "id": "Customer_45",
                "ip_address": "1.2.3.4"
            },
            "payment": {
                "amount": 10000,
                "currency": "THB",
                "customer_name": "Hemachan",
                "account": "642245678952",
                "bank_id": 124,
                "description": "Test payout"
            },
            "return_url": "test_site.com"
        }