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.
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.
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 |
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 thepayment_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 theforce_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 theforce_payment_method
parameter and the bank identifierbanks_id
in thepayment_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.
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 |
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" }