Banks of Vietnam (legacy)

Banks of Vietnam — payment system that uses the banking mechanism for payments and payouts in Vietnam. 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 Vietnam method. It is described in the Banks of Vietnam 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 Vietnamese đồng (VND). The minimal payout amount is 300,000 VND, the maximum amount is 300,000,000 VND. 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
DongA Joint Stock Commercial Bank 130
Sai Gon Thuong Tin Commercial Joint Stock Bank 131
Vietnam Technological and Commercial Joint- stock Bank 132
Joint Stock Commercial Bank for Foreign Trade of Vietnam 133
VietinBank 134
Eximbank Vietnam 135
Bank for Investment and Development of Vietnam 136
Asia Commercial Bank 150
Using preselected payment method

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

By default, banks that support Banks of Vietnam 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 Vietnam 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 Vietnam group with a separate buttons, pass split_banks=true in the request for opening in the payment_methods_options string.
    payment_methods_options: {"vnd_asian_banks": {"split_banks": true}}
    
  • To display a button of a specific bank (one or several) from Banks of Vietnam 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: {"vnd_asian_banks": {"split_banks": true, "banks_id": [135, 136]}}
  • To preselect Banks of Vietnam as the payment method on Payment Page for customers, pass the code vnd_asian_banks in the force_payment_method parameter in the request for opening. The list of the banks from Banks of Vietnam 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 Vietnam group, pass the code vnd_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: 'VND', 
      project_id: 0,
      customer_id: 'user123',
      force_payment_method: 'vnd_asian_banks',
      payment_methods_options: {"vnd_asian_banks": {"banks_id": [135]}},
      signature: "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y1Y4HASCQ9vySO\/RL...g=="
    }
)

Payouts by using Gate

Processing of payouts in this system can be performed only by using the Vietnamese đồng (VND). The minimal payout amount is 300,000 VND, the maximum amount is 300,000,000 VND. Payment processing is supported by banks, the list of them is provided in the table below.

Table 2. List of supported banks, payouts
Bank name Bank ID
DongA Joint Stock Commercial Bank 130
Sai Gon Thuong Tin Commercial Joint Stock Bank 131
Vietnam Technological and Commercial Joint- stock Bank 132
Joint Stock Commercial Bank for Foreign Trade of Vietnam 133
VietinBank 134
Eximbank Vietnam 135
Bank for Investment and Development of Vietnam 136
SAIGON Bank 137
Vietnam International Bank 138
Agribank 139
Asia Commercial Bank 150
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/bFSgv7BpTJMl6...=="
            },
            "customer": {
                "id": "Customer_45",
                "ip_address": "1.2.3.4"
            },
            "payment": {
                "amount": 350000,
                "currency": "VND",
                "customer_name": "Hemachan",
                "account": "642245678952",
                "bank_id": 137,
                "description": "Test payout"
            },
            "return_url": "test_site.com"
        }