How I Built a WooCommerce Payment Gateway for Vietnamese Banks
Source: Dev.to
Introduction
Running an e‑commerce store in Vietnam? International payment gateways often don’t support local banks, leading to cart abandonment. This plugin adds QR Code and Internet Banking support to WooCommerce, letting customers pay with familiar Vietnamese methods.
Features
- Local payment options: QR Code, Internet Banking, ATM cards, and popular Vietnamese e‑wallets.
- Seamless checkout: No redirects to external sites; the checkout stays on your domain.
- Instant payment notifications: Orders update automatically when payment is confirmed.
- Broad bank coverage: Supports major Vietnamese banks that international gateways ignore.
- MIT licensed: Free to use, modify, and distribute.
Installation
Download the plugin
wget https://github.com/quochuydev/woocommerce-nganluong-gateway-plugin/raw/main/nganluong-gateway.zip
Or clone and zip the repository
git clone https://github.com/quochuydev/woocommerce-nganluong-gateway-plugin.git
cd woocommerce-nganluong-gateway-plugin
zip -r nganluong-gateway.zip nganluong-gateway
Upload to WordPress
- In the WordPress admin, go to Plugins → Add New → Upload Plugin.
- Select
nganluong-gateway.zip. - Activate the plugin.
Configure
- Navigate to WooCommerce → Settings → Payments.
- Enter your Ngan Luong merchant account details (API credentials).
Supported Payment Methods
| Method | Description | Use Case |
|---|---|---|
| QR Code | Mobile banking scan‑to‑pay | Quick mobile payments |
| Internet Banking | Direct bank login payment | Desktop customers |
| ATM Cards | Domestic debit cards | Non‑credit card users |
| E‑wallets | Vietnamese digital wallets | Tech‑savvy customers |
Prerequisites
- A Ngan Luong merchant account.
- API credentials from the Ngan Luong integration portal.
- WooCommerce installed on your WordPress site.
Usage
After activation and configuration, customers will see the new payment options at checkout. Payments are processed instantly, and order statuses are updated automatically without leaving your site.
Links
- GitHub repository:
- Ngan Luong integration docs: