Ngân Lượng là cổng thanh toán có tính năng escrow (giữ tiền trung gian) duy nhất tại Việt Nam — sản phẩm của VC Corp từ năm 2009. Phí 1,0-1,8% rẻ nhất trong các cổng VN, settlement T+0 đến T+1.
Phù hợp marketplace 2-bên (P2P), freelance platform, online learning, đơn vị client billing. Bài này hướng dẫn end-to-end + flow escrow + custom dispute handling.
Vì sao escrow Ngân Lượng là độc quyền cho marketplace
Trong 5 cổng thanh toán phổ biến tại VN, chỉ Ngân Lượng có escrow built-in. Cơ chế giữ tiền buyer cho đến khi seller giao đủ hàng/dịch vụ giảm fraud rate 30-50% cho marketplace 2-bên — so với chuyển khoản trực tiếp seller, buyer mất leverage khi seller scam.
Đó là lý do nên cân nhắc Ngân Lượng riêng biệt khỏi 4 cổng còn lại trong batch. Shop bán hàng vật lý B2C bình thường không cần escrow — dùng VNPAY/MoMo rẻ hơn về effort tích hợp.
3 tier phí và tính năng escrow
| Tier | Phí | Tính năng | Phù hợp niche |
|---|---|---|---|
| Cá nhân | 1,8% | Cơ bản — không escrow | Bán cá nhân nhỏ |
| Doanh nghiệp Standard | 1,2-1,5% | Escrow basic 7 ngày | Marketplace nhỏ |
| Enterprise | 1,0-1,2% | Escrow + dispute resolution | Marketplace lớn, freelance platform |
4 use case Ngân Lượng vượt trội các cổng khác
- Marketplace 2-bên P2P: Etsy clone, Fiverr clone, Chợ Tốt — buyer cần escrow protection trước khi seller giao hàng.
- Freelance platform: upwork-style, mốc-based billing — buyer giải ngân theo từng mốc freelancer hoàn thành.
- Online learning có refund policy: khoá học digital — học viên có quyền refund 7-30 ngày nếu không hài lòng.
- Đơn vị client billing: dịch vụ B2B project-based, sản phẩm bàn giao rõ ràng — client giải ngân sau khi review sản phẩm bàn giao.
Bước 1 — Đăng ký Ngân Lượng Merchant nhanh 1-3 ngày
Truy cập nganluong.vn mục “Merchant”. Quy trình đơn giản hơn VNPAY và OnePay rất nhiều — 1-3 ngày làm việc thay vì 5-15 ngày.
3 thông tin cần lưu sau approve
Ngân Lượng có cơ chế credential gọn nhất trong 5 cổng — chỉ 3 thông tin so với MoMo/ZaloPay có 4 và OnePay có 3 với complexity cao hơn.
- Merchant ID: mã định danh shop trong hệ thống Ngân Lượng.
- Receiver Email: email business đã verify với Ngân Lượng — phải khớp email trong hồ sơ giấy phép kinh doanh.
- Secure Pass: password sign request — lưu password manager, CẤM paste public hay commit Git.
Trade-off của onboarding nhanh
Lợi: shop launch nhanh hơn, không stuck ở review process. Bất lợi: limit ban đầu thấp hơn — Ngân Lượng cap volume tier mới 50-100 triệu/tháng cho 3 tháng đầu, upgrade dần sau khi build trust.
- 3 tháng đầu: cap volume 100 triệu/tháng, settle T+1.
- Sau 3 tháng: uncap, có thể upgrade tier Enterprise nếu volume hơn 500 triệu.
- Dispute rate tracking: Ngân Lượng track dispute rate — quá 5% có thể bị giảm tier hoặc suspend.
Bước 2 — Cài plugin Ngân Lượng community từ WordPress.org
Plugin “WooCommerce NganLuong Payment” trên WordPress.org được Ngân Lượng support official dù không phải họ publish trực tiếp. Free, được community duy trì active.
Cài qua wp-admin search
- Vào Plugins → Add New, search keyword “NganLuong WooCommerce”.
- Chọn plugin community được verified, có nhiều install và rating cao.
- Click Install Now rồi Activate.
- Vào WooCommerce → Settings → Payments, tìm row “NganLuong”.
- Click Manage để mở trang cấu hình credential.
Cấu hình 3 credential + endpoint + escrow setting
Trang config có 9 field. Đặc biệt 2 field cuối liên quan escrow — bật mode escrow và set số ngày auto-release nếu buyer không xác nhận.
# WooCommerce → Settings → Payments → NganLuong → Manage
Enable: ✓ tick
Title: "Thanh toán qua Ngân Lượng (escrow protected)"
Description: "Tiền giữ trong Ngân Lượng đến khi giao hàng thành công."
Merchant ID: 12345
Receiver Email: [email protected]
Secure Pass: SECRETPASS123
Endpoint Sandbox: https://sandbox.nganluong.vn:8088/nl35/checkout.api.nganluong.post.php
Endpoint Production: https://www.nganluong.vn/checkout.api.nganluong.post.php
Return URL: https://yourdomain.vn/wc-api/nganluong_return/
Notify URL: https://yourdomain.vn/wc-api/nganluong_notify/
Escrow Mode: ✓ bật cho marketplace
Escrow Days: 7 (auto-release nếu buyer không complain)Bước 3 — Hiểu escrow flow 4 bước cho marketplace
Escrow là điểm khác biệt của Ngân Lượng so với VNPAY/MoMo/ZaloPay/OnePay — tất cả 4 cổng kia chuyển tiền trực tiếp cho seller sau khi buyer thanh toán. Hiểu flow escrow để config đúng cho use case marketplace.
4 bước escrow flow chi tiết
- Buyer thanh toán: qua ATM/Visa/ví Ngân Lượng — tiền vào escrow account của Ngân Lượng giữ trung gian.
- Seller giao hàng/dịch vụ: ship sản phẩm vật lý hoặc deliver dịch vụ digital. Notify Ngân Lượng đã giao qua dashboard hoặc API.
- Buyer xác nhận đã nhận: click “Xác nhận đã nhận” trong tài khoản Ngân Lượng hoặc qua link email confirm.
- Ngân Lượng release tiền: chuyển tiền (đã trừ phí) về STK seller. Hoặc auto-release sau 7-14 ngày nếu buyer không complain.
Khi nào escrow timeout vs dispute
- Auto-release timeout: sau N ngày (config trong plugin), Ngân Lượng tự release tiền cho seller — buyer không response coi như chấp nhận.
- Buyer dispute trước timeout: mở case dispute, escrow frozen — đợi Ngân Lượng resolve, có thể mất 7-30 ngày.
- Resolution thuận lợi buyer: Ngân Lượng refund toàn bộ về buyer, seller mất đơn.
- Resolution thuận lợi seller: release tiền cho seller, buyer được giải thích lý do.
Bước 4 — Go live và custom logic dispute handling
Sau khi test sandbox pass 3-5 đơn cả happy path + dispute case, switch Production trong plugin. Setup quy trình nội bộ xử lý dispute trong 3-5 ngày — quá hạn escalate Ngân Lượng support.
Custom 1 — Auto-extend escrow cho đơn lớn
Đơn giá trị cao nên giữ escrow lâu hơn để giảm risk seller scam — buyer có thêm thời gian inspect sản phẩm bàn giao trước khi confirm. Filter hook adjust escrow days theo total order.
add_filter('nganluong_escrow_days', 'extend_escrow_high_value');
function extend_escrow_high_value($days, $order) {
$total = $order->get_total();
if ($total > 5000000) {
return 14; // Đơn lớn: 14 ngày escrow
} elseif ($total > 1000000) {
return 10; // Đơn vừa: 10 ngày
}
return 7; // Đơn nhỏ: 7 ngày default
}Custom 2 — Email reminder buyer xác nhận trước timeout
Buyer hay quên xác nhận, dẫn đến auto-release dù chưa nhận hàng. Setup cron gửi email reminder 2 ngày trước escrow timeout — giảm tỷ lệ dispute sau release.
- Cron schedule: chạy daily ngoài giờ peak, query order có escrow_expire_at – now < 2 days.
- Email content: nhắc khách click confirm hoặc mở dispute nếu chưa nhận hàng — kèm link direct.
- Track engagement: log reminder đã gửi, không gửi duplicate cho cùng order.
5 lỗi phổ biến khi tích hợp Ngân Lượng và cách fix
Ngân Lượng có codebase plugin community ít maintain hơn các cổng official như VNPAY và OnePay. Dưới đây là 5 lỗi gặp nhiều nhất qua kinh nghiệm Web22.
- Secure Pass sai gây reject request: Ngân Lượng API trả về error. Re-paste Secure Pass đảm bảo không có space, verify sign data theo đúng thứ tự field trong docs Ngân Lượng.
- Notify URL không nhận callback: firewall hosting block IP Ngân Lượng. Whitelist range
113.171.241.0/24trong cPanel hoặc Plesk security setting. - Escrow không tự release sau timeout: buyer không xác nhận, không có dispute, nhưng tiền vẫn pending. Check field
escrow_daystrong plugin config — đảm bảo set đúng 7-14 ngày phù hợp use case. - Settlement chậm khi có dispute: dispute mở phải resolve trước khi release tiền cho seller. Setup workflow nội bộ xử lý dispute trong 3-5 ngày, escalate Ngân Lượng support nếu khách hàng không response.
- Plugin không tương thích WooCommerce mới: plugin community update chậm theo WooCommerce major release. Test trên staging trước khi update WooCommerce production — fork plugin tự maintain nếu cần.
Workflow xử lý dispute trong 5 ngày làm việc
Dispute là phần phức tạp nhất khi vận hành marketplace với escrow. Setup workflow chuẩn xử lý dispute trong 5 ngày làm việc — quá hạn khách mất kiên nhẫn, rating shop bị ảnh hưởng.
5 bước resolution dispute chuẩn
- Ngày 1 — Acknowledge: reply buyer trong 4 giờ confirm đã nhận dispute, gửi link upload bằng chứng (hình ảnh, video, chat log với seller).
- Ngày 1-2 — Notify seller: gửi notification seller về dispute, request response trong 24 giờ kèm bằng chứng đã giao hàng (tracking, delivery confirmation).
- Ngày 2-3 — Review bằng chứng: ops team review song song bằng chứng 2 bên, tham khảo policy marketplace đã commit với khách.
- Ngày 3-4 — Đề xuất giải pháp: propose resolution cho cả 2 bên — refund full, partial refund, ship lại, hoặc release tiền cho seller.
- Ngày 4-5 — Execute: trigger API Ngân Lượng refund/release theo resolution, đóng case trong dashboard.
Template document dispute để track
Mỗi dispute mở 1 ticket trong CRM/Helpdesk (Freshdesk, Crisp, Zendesk) với template field chuẩn — sau này analytics dispute pattern để cải tiến policy marketplace.
- Field bắt buộc: order_id, buyer_id, seller_id, dispute_reason, dispute_amount, evidence_links, resolution, resolution_date.
- SLA tracking: measure thời gian resolution per category — refund partial nhanh hơn refund full nhanh hơn dispute phức tạp.
- Monthly analytics: categorize dispute reason (sản phẩm sai, không nhận hàng, chất lượng kém) — identify root cause systemic để fix.
Tích hợp đa cổng và bài liên quan
Ngân Lượng nên đặt riêng cho use case marketplace/freelance. Shop hybrid (vừa bán hàng vật lý vừa có marketplace 2-bên) có thể tích hợp Ngân Lượng cho phần marketplace + VNPAY cho phần bán hàng vật lý.
Tham khảo các cổng còn lại: tích hợp VNPAY cho mass market 40+ banks, tích hợp MoMo cho khách trẻ B2C, tích hợp OnePay cho shop B2B corporate card, tích hợp ZaloPay để leverage Zalo OA marketing.
Marketplace 2-bên xử lý PII đa bên phải hardening security đặc biệt — xem bảo mật shop WooCommerce 7 lớp để bảo vệ data của cả buyer và seller.
Câu hỏi thường gặp về tích hợp Ngân Lượng
Khi nào cần escrow thay vì payment trực tiếp?
Cần escrow khi shop là marketplace 2-bên (Etsy clone, Fiverr clone), freelance platform mốc-based, online learning có refund policy, hoặc bán dịch vụ B2B project-based cần đảm bảo sản phẩm bàn giao.
Shop bán hàng vật lý B2C bình thường không cần escrow — phức tạp hoá flow checkout + delay tiền cho seller. Dùng VNPAY/MoMo rẻ hơn về effort tích hợp và vận hành.
Phí Ngân Lượng cao hơn VNPAY có đáng không?
Thật ra Ngân Lượng (1,0-1,8%) tương đương hoặc rẻ hơn VNPAY (1,1-2,2%) ở các tier doanh nghiệp. Trade-off chính là escrow — giảm fraud rate cho marketplace 30-50%, đáng đầu tư nếu use case là marketplace.
Shop bán hàng vật lý B2C bình thường: dùng VNPAY rẻ hơn về integration effort, plugin official được maintain tốt hơn plugin community Ngân Lượng.
Buyer không xác nhận hoài thì sao?
Auto-release sau N ngày (config escrow_days trong plugin) nếu không có dispute. Default 7 ngày, có thể configure shorter (3-5 ngày) cho dịch vụ digital instant delivery.
Lâu hơn (14-30 ngày) cho dịch vụ sản phẩm bàn giao phức tạp như freelance project, đơn vị mốc. Setup email reminder 2 ngày trước timeout để giảm tỷ lệ dispute sau release.
Ngân Lượng có support subscription định kỳ không?
Không trực tiếp. Ngân Lượng focus 1-time payment với escrow protection, không phải định kỳ billing.
Plugin community cũng không có module subscription.
Shop SaaS subscription nên dùng Stripe (offshore) hoặc VNPAY Subscription API. Ngân Lượng phù hợp marketplace + freelance + online learning — không phải SaaS.
Plugin Ngân Lượng có support custom field không?
Plugin community basic chỉ pass standard field (amount, customer email, order_id). Custom field như freelance_project_id hay milestone_number cần fork plugin và add code tự.
Cho marketplace lớn hoặc freelance platform: nên thuê dev custom plugin hoặc dùng Ngân Lượng REST API trực tiếp thay vì plugin generic. Plugin official hỗ trợ extension qua filter hook.
Tích hợp Ngân Lượng + escrow turnkey cho marketplace
Setup Ngân Lượng end-to-end gồm config escrow flow, custom dispute handling, email reminder buyer, integration với role buyer-seller WooCommerce marketplace — mất 5-10 ngày tự mò nếu chưa có dev kinh nghiệm marketplace platform.
Web22 ship turnkey Ngân Lượng trong 3-5 ngày, bao gồm cả workflow xử lý dispute + dashboard monitoring escrow status. Đội Web22 dev WooCommerce full feature — báo giá rõ phạm vi, có SLA cam kết thời gian hoạt động cho marketplace 2-bên.
