Market specifications

Do you want to know more information about Vietnam's market? Go to the Accelerate Growth in Asia’s Leading eCommerce Hubs article.

Country reference

`country` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.document.id` format
`VN`	`VND`	2	VNID	9 or 13 digits

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	P2P
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`beneficiary.bank_account.code`	Yes	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes
`remitter.nationality`	-	-	Yes

Wallet transfers

Wallet transfer parameters	B2C	B2B	P2P
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`beneficiary.instant_payment.type`	Yes	Yes	Yes
`beneficiary.phone`	Yes	Yes	Yes
`beneficiary.address`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes
`remitter.nationality`	-	-	Yes

Payment methods

Vietnam supports payouts via Bank transfers and Wallet transfers. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Use Wallet transfers for instant payments to mobile wallets. Use Bank transfers when sending funds directly to a bank account.

Bank transfers

Bank transfers in Vietnam require detailed account information, including bank code, bank account number, amount, and currency. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the bank codes section for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`amount`	Payout amount (in the currency set in the `currency` field). Use up to 2 decimal numbers.
`currency`	Payout currency. For Vietnam, use `VND` or `USD`.
`country`	Country code. For Vietnam, use `VN`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Only applies when the beneficiary is an individual. Maximum 50 characters.
`beneficiary.bank_account.code`	Beneficiary's bank account code. See bank codes below.
`beneficiary.bank_account.account`	Beneficiary's bank account number. Maximum 45 characters.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's address street. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's address city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's address country. ISO 3166-1 alpha-2 code.. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's nationality. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "123456789",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "payment_method_id": "BANK_TRANSFER",
  "country": "VN",
  "amount": 10,
  "currency": "VND",
  "beneficiary": {
    "first_name": "Juan",
    "last_name": "Alonso",
    "document": {
      "id": "27836873654",
      "type": "VNID"
    },
    "bank_account": {
      "code": "13",
      "account": "1234567890",
      "type": "CHECKING"
    }
  },
  "notification_url": "https://thisisawebsite.net/payments"
}

Wallet transfers

Wallet transfers enable real-time transfers using a mobile phone number linked to a wallet.

The account_type field must indicate the type of wallet being used (e.g., MoMo, VNPAY, VNPT Pay, Sacombank, ZaloPay). The phone field must be present and correctly formatted.

Mandatory parameters

The table below outlines the required parameters for Wallet transfers.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For wallet, use `INSTANT_PAYMENT`.
`purpose`	Payout purpose code. See purpose codes reference.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`amount`	Payout amount (in the currency set in the `currency` field). Use up to 2 decimal places.
`currency`	Payout currency. For Vietnam, use `USD` or `VND`.
`country`	Country code. For Vietnam, use `VN`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Only applies when the beneficiary is an individual. Maximum 50 characters.
`beneficiary.address.street`	Beneficiary's address street. 200 characters.
`beneficiary.instant_payment.type`	Beneficiary's instant payment account type. Type of wallet being used: `MOMO`, `VNPAY`, `VNPT PAY`, `SACOMBANK`, `ZALOPAY`.
`beneficiary.instant_payment.id`	Beneficiary's wallet ID. Maximum 45 characters.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's address street. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's address city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's address country. ISO 3166-1 alpha-2 code.. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's nationality. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "8tSHXacig",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "payment_method_id": "WALLET",
  "country": "VN",
  "amount": 10,
  "currency": "VND",
  "beneficiary": {
    "first_name": "Test",
    "last_name": "Test",
    "address": "test address",
    "instant_payment": {
      "type": "MOMO",
      "id": "+8412345678901"
    }
  }
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Vietnam.

Bank codes

Bank Name	Other name	Bank Code
Bac A Commercial Joint Stock Bank (Bac A Bank)	BAB	73
CIMB Bank Limited	CIMB Bank	54
Cooperative Bank of Vietnam	CoopBank	43
DBS Bank Ltd - Ho Chi Minh Branch	DBS Bank	75
HSBC Bank Vietnam	HSBC Bank	37
Industrial Bank of Korea - Ho Chi Minh Branch	IBK HCM	77
Industrial Bank of Korea– Ha Noi branch	IBK - HN	48
KasikornBank Public Company Limited	Kasikornbank	69
Keb Hana Bank - Ha Noi Branch	KEB Hana Bank	76
Keb Hana Bank - Ho Chi Minh Branch	KEB Hana Bank	72
Kookmin - Chi nhánh Hà Nội	Kookmin Bank	63
Kookmin - Chi nhánh Thành phố Hồ Chí Minh	KookminBank	64
Liobank by OCB	Liobank Bank transfer app (not a bank)	68
Nam A Commercial Join Stock Bank	NamABank	39
Ngân hàng TNHH Indovina	IVB	46
Ngân hàng số CAKE by VPBank	CAKE Bank transfer app (not a bank)	65
Ngân hàng số Ubank by VPBank	Ubank Bank transfer app (not a bank)	66
NH Lien Doanh Viet Nga	VRBank	16
NH Nong Nghiep va Phat Trien Nong Thon Vietnam *	Agribank	13
NH Vietnam Thuong Tin	VietBank	15
NHTMCP A Chau	ACB	18
NHTMCP An Binh	ABBank	4
NHTMCP Ban Viet	Vietcapital Bank	14
NHTMCP Bao Viet	BVB	32
NHTMCP Buu Dien Lien Viet	LienVietPostBank	30
NHTMCP Cong Thuong Vietnam	Vietinbank	2
NHTMCP Dai Chung Vietnam	PVcomBank	7
NHTMCP Dai Duong	OceanBank	5
NHTMCP Dau Khi Toan Cau	GP Bank	9
NHTMCP Dau Tu va Phat Trien Vietnam	BIDV Bank	11
NHTMCP Dong A *	Dong A Bank	10
NHTMCP Dong Nam A	SeABank	6
NHTMCP Kien Long	KienLongBank	12
NHTMCP Ky Thuong Vietnam	Techcombank	26
NHTMCP Ngoai Thuong Vietnam	Vietcombank (VCB)	17
NHTMCP Phat Trien Thanh Pho HCM	HDBank	22
NHTMCP Phuong Dong	OCB	27
NHTMCP Quan Doi	MBBank	23
NHTMCP Quoc Dan	NCB	28
NHTMCP Quoc Te Vietnam	VIB	25
NHTMCP Sai Gon Ha Noi	SHB	21
NHTMCP Saigon	SCB	35
NHTMCP Saigon Cong Thuong	Saigonbank	3
NHTMCP Saigon Thuong Tin	Sacombank	1
NHTMCP Tien Phong	TPBank	20
NHTMCP Vietnam Thinh Vuong	VPBank	24
NHTMCP Xang Dau Petrolimex	PG Bank	8
NHTMCP Xuat Nhap Khau Vietnam	Eximbank	19
NHTNHH MTV Hongleong Vietnam	HLBVN	29
NHTNHH MTV Public Vietnam	Public Bank VN	34
NHTNHH MTV Shinhan Vietnam	ShinhanVN	33
Nonghuyp - Chi nhánh Hà Nội(NHB)	Nonghyup Bank	60
Standard Chartered Bank Viet Nam Limited	Standard Chartered Bank	52
Timo by Ban Viet Bank	Timo Bank transfer app (not a bank)	67
UMEE by KienlongBank	UMEE Bank transfer app (not a bank)	71
United Overseas Bank Viet Nam	UOB Bank	53
Vietnam Bank for Social Policies (VBSP)	VBSP	74
Vietnam Asia Commercial Joint Stock Bank (VietA)	VietABank	57
NH Vietnam Thuong Tin	VietBank	15
NHTMCP Ban Viet	Vietcapital Bank	14
NHTMCP Ngoai Thuong Vietnam	Vietcombank (VCB)	17
NHTMCP Cong Thuong Vietnam	Vietinbank	2
NH Lien Doanh Viet Nga	VRBank	16
NHTMCP Vietnam Thinh Vuong	VPBank	24
Woori Bank Vietnam	WooriBank	49