Payment gateway in Vietnam: how to accept VietQR, MoMo and ZaloPay on your website
How Vietnamese buyers pay online, how a payment gateway handles VietQR, MoMo and ZaloPay from QR code to webhook, the risks to watch and a checklist for choosing a provider.
5 min de lectura
Este artículo aún no está disponible en Español. Se muestra en English.
También disponible en: Tiếng Việt
Online payments in Vietnam are changing fast. Most buyers do not use credit cards when shopping online; they transfer money by scanning a QR code with their banking app or pay with e-wallets such as MoMo and ZaloPay. A website that only accepts cards misses most Vietnamese customers.
This guide explains how Vietnamese buyers pay online, how a payment gateway handles VietQR, MoMo and ZaloPay, which risks to watch and how to choose a provider.
Common ways to pay online
| Method | How it works | For whom |
|---|---|---|
| VietQR | The customer scans a QR code with a banking app; amount and note are pre-filled | Bank customers (almost everyone) |
| MoMo | Paid from the MoMo wallet by QR or app switch | E-wallet users |
| ZaloPay | Wallet linked to the Zalo app, paid by QR or app switch | Zalo users |
| Cards | Domestic or international cards | Card holders who shop online |
VietQR is the national QR standard run by NAPAS and supported by almost every bank. When the customer scans, the banking app fills in the account, amount and transfer note, and the money usually arrives within seconds over the 24/7 fast-transfer network.
The problem with manual transfers
Many shops still share a personal account number and check the statement by hand. That causes three problems:
- Hard reconciliation: hundreds of transfers a day, customers writing the wrong note, no idea who paid which order.
- Fake screenshots: edited or unfinished transfer screenshots.
- Slow delivery: orders wait for a person to check, especially at night.
How a payment gateway handles it
| Step | What happens | Who does it |
|---|---|---|
| 1. Create a payment | Your website asks the gateway for a charge for the order amount | Your server, via API |
| 2. Show the QR | The gateway returns a dynamic VietQR code (or wallet link) with the amount and a unique reference | Gateway → your checkout |
| 3. Customer pays | Scans with a banking or wallet app and confirms | Customer |
| 4. Confirmation | The bank or wallet confirms to the gateway | Bank/wallet → gateway |
| 5. Webhook | The gateway sends a signed webhook: this order is paid | Gateway → your server |
| 6. Fulfilment | Your system marks the order paid and delivers or credits a balance | Your server |
| 7. Settlement | Paid funds become available to withdraw | Gateway → your account |
The key is a unique reference per order: when money arrives, the gateway knows exactly which order was paid — no manual matching.
Risks and how to handle them
Fake transfer screenshots. Rule: never deliver on a screenshot, only when the webhook confirms.
Wrong amount or note. A dynamic QR pre-fills the amount and reference, which removes almost all of these errors.
Expired payments. A customer reopens an old QR after it expired. Create a new charge instead of reusing the old code.
Missed webhooks. If your server is down you can miss a confirmation. Choose a gateway that retries webhooks and offers a status API, and handle webhooks idempotently so nothing is credited twice.
For gaming, trading and digital goods
- Gaming and top-ups: credit the balance as soon as the webhook arrives.
- Trading platforms: take deposits in VND with a clear record of every payment.
- Digital goods: deliver codes, vouchers and subscriptions right after confirmation.
Checklist for choosing a gateway in Vietnam
- Dynamic VietQR with a unique reference per order.
- MoMo and ZaloPay for wallet users.
- Signed webhooks with retries, and a status API.
- A sandbox to simulate paid, failed and expired payments.
- Clear fees, nothing on failed payments.
- Settlement that suits you: local account, foreign account or stablecoins.
- Reports with gross, fee and net per payment.
- One API for several countries if Vietnam is one of several markets.
Step by step
- Create a merchant account and add your website.
- Create a sandbox API key and keep it on your server only.
- Set your webhook URL and save the secret.
- At checkout, create the charge by API with the amount and your own order reference.
- Show the QR code, or open the wallet on mobile.
- Verify each webhook's signature and mark the order paid only once.
- Test every outcome in the sandbox, then switch to a live key.
How PAYWISE handles Vietnam
PAYWISE is an API-first payment platform. Indonesia (QRIS) and crypto payments are live today, and Vietnam (VietQR, MoMo, ZaloPay) opens on request: merchants who ask first are prepared first. When Vietnam opens for your account, you keep the same API, webhooks and dashboard as everywhere else.
See the Vietnam page and send a request in two minutes.
Frequently asked questions
How is VietQR different from a normal transfer? VietQR pre-fills the account, amount and note, so customers type nothing and make fewer mistakes.
How fast is a VietQR payment? Usually a few seconds, including nights and weekends.
Can a customer cancel a completed transfer? Not like a card chargeback. Refunds are made by the merchant with a new transfer.
Can a foreign company get paid in Vietnam? Yes, through a provider that collects locally and settles to you. Ask how funds are settled and converted.
Sources: NAPAS — VietQR, MoMo, ZaloPay. This article is general information, not legal or financial advice.

