Online banking in Vietnam
To enable online banking in Vietnam, you need to use direct integration. When creating a payment, send a request with the following parameters:
Parameter | Type | Required | Description |
---|---|---|---|
pos_id | UUID | ✅ | Merchant's identifier (POS_ID ) |
mode | MODE | ✅ | direct |
method | METHOD | ✅ | Payment method (purchase ) |
amount | Number | ✅ | Transaction amount. Must be a positive number |
currency | CURRENCY | ✅ | Transaction currency (ISO_4217) |
order_3ds_bypass | String | ✅ | 3-D Secure flow option |
order_id | String | ✅ | Unique identifier of order |
description | String | ✅ | Payment description |
payway | String | ✅ | banking |
server_url | URL | Webhook notification will be sent to this URL | |
result_url | URL | Customer will be redirected to this URL after payment. | |
properties.pay_method | String | ✅ | bank ID |
customer_ip | String | payer’s IP |
Request example:
{
"pos_id": "'$POS_ID'",
"mode": "direct",
"method": "purchase",
"amount": 1,
"payway": "banking",
"currency": "VND",
"order_id": "'$ORDER_ID'",
"description": "Description",
"customer_ip": "1.2.3.4",
"order_3ds_bypass": "supported",
"properties": {
"pay_method": "513"
},
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://example.com/result"
}