How I Built a WooCommerce Payment Gateway for Vietnamese Banks

Published: (January 13, 2026 at 11:25 PM EST)
1 min read
Source: Dev.to

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

  1. In the WordPress admin, go to Plugins → Add New → Upload Plugin.
  2. Select nganluong-gateway.zip.
  3. Activate the plugin.

Configure

  • Navigate to WooCommerce → Settings → Payments.
  • Enter your Ngan Luong merchant account details (API credentials).

Supported Payment Methods

MethodDescriptionUse Case
QR CodeMobile banking scan‑to‑payQuick mobile payments
Internet BankingDirect bank login paymentDesktop customers
ATM CardsDomestic debit cardsNon‑credit card users
E‑walletsVietnamese digital walletsTech‑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.

  • GitHub repository:
  • Ngan Luong integration docs:
Back to Blog

Related posts

Read more »