PAYWISE
← Todos os artigos

Guias

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 leitura

Este artigo ainda não está disponível em Português. Ele é exibido em English.

Também disponível em: Tiếng Việt

Payment gateway in Vietnam: how to accept VietQR, MoMo and ZaloPay on your website

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:

  1. Hard reconciliation: hundreds of transfers a day, customers writing the wrong note, no idea who paid which order.
  2. Fake screenshots: edited or unfinished transfer screenshots.
  3. 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

  1. Dynamic VietQR with a unique reference per order.
  2. MoMo and ZaloPay for wallet users.
  3. Signed webhooks with retries, and a status API.
  4. A sandbox to simulate paid, failed and expired payments.
  5. Clear fees, nothing on failed payments.
  6. Settlement that suits you: local account, foreign account or stablecoins.
  7. Reports with gross, fee and net per payment.
  8. One API for several countries if Vietnam is one of several markets.

Step by step

  1. Create a merchant account and add your website.
  2. Create a sandbox API key and keep it on your server only.
  3. Set your webhook URL and save the secret.
  4. At checkout, create the charge by API with the amount and your own order reference.
  5. Show the QR code, or open the wallet on mobile.
  6. Verify each webhook's signature and mark the order paid only once.
  7. 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.

Mais artigos

Comece hoje com uma chave de sandbox.

Crie uma conta, gere uma chave de sandbox e envie sua primeira transação pelo playground em minutos.