Vietnam

Accept 9Pay, ATM Card, and VIET QR payments in Vietnam with Onerway.

Vietnam's payment landscape is rapidly evolving with strong adoption of mobile wallets and QR-based payments. serves as the country's standardized QR payment infrastructure, while digital wallets like 9Pay offer convenient payment solutions for everyday transactions.

Payment service policies may change at any time and may vary by region. This page is for reference only and will be updated periodically.

At a Glance

Country

Vietnam (VN)

Currency

Vietnamese Dong (VND)

Minimum Amount

10,000 VND

Refunds

✅ Supported

Chargeback

—

Document Required

Document Requirements

Vietnamese payment methods require national identification for compliance purposes.

Document	Format	Required For
	9 or 12 digits	9Pay, VIET QR

The identityNumber field is required for 9Pay and VIET QR transactions. ATM Card does not require an identity document.

Local Payment Methods (LPMS)

VIET QR is Vietnam's national QR payment standard enabling interoperable payments. It's recommended for broad payment coverage as it allows customers to scan and pay from any supported banking app.

Quick Comparison

Method	Type	Expiration	Confirmation	Refund	Max Amount	Best For
VIET QR	QR Payment	30 min	Immediate	✅	299,999,999 VND	Universal QR payments
9Pay	Wallet	30 min	Immediate	✅	—	Multi-channel payments
ATM Card	Bank Card	30 min	Immediate	✅	299,999,999 VND	Vietnamese bank card holders

All payment methods have a 30-minute expiration window. Transactions must be completed within this time frame.

Integration Details

Field	Type	Description
`orderAmount`	string	Payment amount
`orderCurrency`	string	VND
`country`	string	VN
`lpmsInfo`	string	Method-specific JSON
`firstName`	string	Consumer's given name
`lastName`	string	Consumer's family name
`email`	string	Consumer's email
`identityNumber`	string	VNID (9 or 12 digits) - for 9Pay, VIET QR

Method	lpmsInfo
VIET QR	`{"lpmsType":"VIET_QR"}`
9Pay	`{"lpmsType":"NINE_PAY_EWALLET"}`
ATM Card	`{"lpmsType":"ATM_CARD","bankName":"","walletAccountId":"<card_number>","walletAccountName":"<cardholder_name>","issueDate":"<MM/YY>"}`

ATM Card requires additional card information: walletAccountId (16-digit card number), walletAccountName (cardholder name in uppercase), and issueDate (MM/YY format). Replace placeholders with actual customer data.

Type	API	User Flow
DIRECT	Payment API	Merchant → Payment Page
REDIRECT	Checkout API	Merchant → Onerway Checkout → Payment Page

DIRECT for custom checkout UI with full control.
REDIRECT for quick integration with Onerway's hosted payment selection.

Payment Method Details

Best for: Universal QR code payments, reaching customers across all Vietnamese banks.

VIET QR is Vietnam's national QR payment standard that enables interoperable QR code payments across banks and e-wallets. Customers can scan the QR code using any supported banking app to complete transactions instantly.

VIET QR is compatible with all major Vietnamese banks including Vietcombank, BIDV, Techcombank, VietinBank, MB Bank, and 40+ other financial institutions.

Feature	Value
Expiration	30 minutes
Min Amount	10,000 VND
Max Amount	299,999,999 VND
Confirmation	Immediate
Refund	✅
Identity Needed	Yes (VNID)

Best for: Multi-channel payments, customers who prefer diverse payment options.

9Pay is a comprehensive payment platform that allows customers to pay using credit cards, ATM cards, bank transfers, e-wallets, and other methods. It provides a unified payment experience across multiple payment channels.

Feature	Value
Expiration	30 minutes
Min Amount	10,000 VND
Confirmation	Immediate
Refund	✅
Identity Needed	Yes (VNID)

Thailand

Accept PromptPay, Rabbit LINE Pay, TrueMoney, and Krungsri Online payments in Thailand with Onerway.

Malaysia

Accept FPX, Boost, Touch 'n Go, ShopeePay, and Mcash payments in Malaysia with Onerway.