Skip to main content

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:

ParameterTypeRequiredDescription
pos_idUUID✅Merchant's identifier (POS_ID)
modeMODE✅direct
methodMETHOD✅Payment method (purchase)
amountNumber✅Transaction amount. Must be a positive number
currencyCURRENCY✅Transaction currency (ISO_4217)
order_3ds_bypassString✅3-D Secure flow option
order_idString✅Unique identifier of order
descriptionString✅Payment description
paywayString✅banking
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment.
properties.pay_methodString✅bank ID
customer_ipStringpayer’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"
}