DEV Community: anh anh

Cổng thanh toán quét QR, báo biến động đa kênh

anh anh — Tue, 06 Oct 2026 04:32:39 +0000

Khi mỗi đơn chuyển khoản đều cần một người canh ứng dụng ngân hàng

Với nhiều cửa hàng online, việc nhận thanh toán chuyển khoản vẫn làm thủ công. Khách chuyển tiền rồi gửi ảnh chụp màn hình. Người bán mở ứng dụng ngân hàng dò từng giao dịch, sau đó mới xác nhận đơn.
Cách làm này có bốn điểm yếu:
• Chậm: khách phải chờ xác nhận, đơn bị treo ngoài giờ làm việc.
• Dễ sai: nhiều đơn cùng số tiền, khách ghi sai nội dung hoặc chuyển thiếu.
• Rủi ro: ảnh chụp màn hình không chứng minh được tiền đã thực sự vào tài khoản.
• Khó phối hợp: nhân viên bán hàng, kho và kế toán đều cần biết tiền đã về, nhưng chỉ chủ tài khoản xem được ứng dụng ngân hàng.
Cổng thanh toán PionPay giải quyết bài toán này bằng một nguyên tắc đơn giản. Khách chỉ cần quét mã. Tiền vừa vào tài khoản, thông báo biến động số dư đã có mặt ở đúng nơi bạn đang làm việc.

Cổng thanh toán PionPay hoạt động thế nào?

Từ lúc khách quét mã đến lúc đơn hàng được xác nhận chỉ gồm 5 bước, và bạn không phải làm bước nào bằng tay:

Tạo mã QR thanh toán cho đơn hàng. Mã QR chứa tài khoản nhận, số tiền và nội dung chuyển khoản theo đơn.
Khách quét mã bằng ứng dụng ngân hàng và xác nhận chuyển tiền. Khách không cần gõ số tài khoản hay số tiền, nên hạn chế được việc ghi sai.
Tiền vào tài khoản ngân hàng đã liên kết. PionPay ghi nhận biến động số dư ngay lập tức.
PionPay gửi thông báo đến các kênh bạn đã cài đặt: Telegram, Zalo, Google Sheets hoặc webhook trên website bán hàng.
Đơn hàng được tự động xác nhận ngay khi khách chuyển khoản. Giao dịch cũng được tự động phân loại và ghi nhận vào sổ thu chi.

PionPay liên kết với hơn ngân hàng, trong đó có BIDV, ACB, TPBank và PGBank. Mọi tài khoản được gom về một bảng điều khiển duy nhất.

Nhận thông báo ở đâu? Chọn kênh theo cách bạn làm việc

Mỗi người trong cửa hàng cần biết tiền đã về theo một cách khác nhau. Chủ shop muốn biết ngay trên điện thoại, kế toán cần sổ sách, còn website cần tín hiệu để tự cập nhật đơn. PionPay gửi biến động số dư đến đúng kênh cho từng nhu cầu.

Với gói Doanh nghiệp, tính năng chia sẻ biến động giúp nhiều người cùng nắm được tiền về, mà không ai phải được giao quyền truy cập ứng dụng ngân hàng.
Dành cho lập trình viên: nhận webhook trên website bán hàng
Nếu bạn có website hoặc phần mềm bán hàng riêng, webhook giúp đơn hàng tự chuyển sang "Đã thanh toán". Mỗi khi có biến động số dư, PionPay gửi một yêu cầu HTTP về địa chỉ bạn khai báo. Ví dụ dưới đây viết bằng Node.js (Express); tên trường chỉ để minh họa, khi tích hợp hãy làm theo tài liệu tích hợp của PionPay.

import express from "express";

const app = express();
app.use(express.json());

const processed = new Set(); // thực tế: lưu DB, khóa duy nhất theo mã giao dịch

app.post("/webhooks/pionpay", async (req, res) => {
  // 1. Xác thực nguồn gửi theo hướng dẫn tích hợp
  if (!isFromPionPay(req)) return res.sendStatus(401);

  // 2. Tên trường minh họa
  const { transactionId, amount, description } = req.body;

  // 3. Mỗi giao dịch chỉ xử lý một lần
  if (processed.has(transactionId)) return res.sendStatus(200);
  processed.add(transactionId);
  res.sendStatus(200); // phản hồi ngay, xử lý nghiệp vụ sau

  // 4. Khớp mã đơn trong nội dung chuyển khoản
  const orderCode = description?.toUpperCase().match(/DH\d{6}/)?.[0];
  if (orderCode) await markOrderPaid(orderCode, amount, transactionId);
});

Một vài lưu ý khi tích hợp:
• Luôn xác thực nguồn gửi trước khi cập nhật đơn, không nhận mọi request gửi tới địa chỉ webhook.
• Kiểm tra số tiền so với giá trị đơn, và có hướng xử lý riêng cho trường hợp chuyển thiếu hoặc chuyển thừa.
• Giao dịch không khớp mã đơn nên đưa vào danh sách chờ duyệt tay, không tự đoán đơn.

Bắt đầu dùng cổng thanh toán PionPay

Cả hai gói đều có sẵn cổng thanh toán và Webhook/API:
Doanh nghiệp: 50.000đ/tháng - 01 tài khoản ngân hàng, chia sẻ biến động, cổng thanh toán, Webhook/API

Cá nhân: 99.000đ/tháng - 01 tài khoản, không giới hạn giao dịch, cổng thanh toán, Webhook/API

Bạn có thể bắt đầu nhận thanh toán tự động sau 4 bước:

Đăng ký tài khoản PionPay.
Liên kết tài khoản ngân hàng nhận tiền.
Chọn kênh nhận thông báo: Telegram, Zalo, Messenger, Google Sheets hoặc webhook.
Tạo mã QR cho đơn hàng và gửi cho khách.

Từ đây, khách chỉ cần quét mã, phần còn lại để PionPay lo. Đăng ký tài khoản ngay tại pionpay.vn, hoặc nhắn cho PionPay qua Facebook

good

anh anh — Wed, 30 Sep 2026 03:13:25 +0000

Nguyễn Hương

Sep 30

What Is a Webhook? A Practical Guide (Plus a Real-World Bank Transfer Use Case)

#webhooks #apigateway #webdev #node

7 min read

must try

anh anh — Thu, 24 Sep 2026 07:59:54 +0000

Nguyễn Hương

Sep 16

PionPay: Không cần tự kết nối API từng ngân hàng — Chỉ cần gắn webhook của PionPay

#api #webhook #fintech #webdev

5 min read

Tạo tài khoản VA trên ACB cùng PionPay: nhận tiền và đối soát rõ ràng hơn

anh anh — Thu, 24 Sep 2026 07:53:27 +0000

Khi nhiều đơn hàng và khoản thu đổ về một tài khoản, việc xác định tiền đến từ ai, thuộc đơn nào rất mất thời gian. Với PionPay, bạn có thể tạo tài khoản VA (Virtual Account) trên ACB để tách và quản lý các khoản thu rõ ràng hơn.

Tài khoản VA trên ACB là gì?

Tài khoản VA (Virtual Account) là tài khoản định danh gắn với từng khách hàng, đơn hàng hoặc mục đích cụ thể, dùng để nhận tiền. Mỗi VA có một định danh riêng nên khi tiền vào, hệ thống nhận diện ngay giao dịch thuộc về ai. Toàn bộ khoản thu vẫn tập trung về tài khoản chính của bạn tại ACB.

VA hoạt động thế nào khi khách chuyển tiền?

VA hoạt động bằng cách gán cho mỗi khách hàng hoặc đơn hàng một số tài khoản định danh riêng để nhận tiền. Khi khách chuyển vào đúng VA của mình, hệ thống nhận diện được ngay khoản tiền đó thuộc về ai, đồng thời tiền vẫn được ghi nhận về tài khoản chính để bạn quản lý tập trung.

VÍ DỤ CÁCH GÁN VA

Chi nhánh A → VA A

Chi nhánh B → VA B

Chi nhánh C → VA C

Khi phát sinh giao dịch, việc xác định tiền đến từ đâu và thuộc về ai trở nên rõ ràng.

Với cách tổ chức này, thay vì kiểm tra từng giao dịch trên một tài khoản chung, bạn biết ngay mỗi khoản thu gắn với khách hàng hay đơn hàng nào - nền tảng để đối soát nhanh và chính xác.

Tạo và quản lý VA trên PionPay mang lại gì?

PionPay cho phép bạn tạo và quản lý VA trên ACB ngay trên hệ thống, với các khả năng chính:

Tạo tài khoản VA trên ACB trực tiếp trong hệ thống PionPay, không cần thao tác rời rạc nhiều nơi.

Gắn VA với đối tượng hoặc nhu cầu tương ứng theo đúng cách doanh nghiệp bạn tổ chức quản lý giao dịch.

Nhận tiền qua từng VA thay vì phụ thuộc hoàn toàn vào một tài khoản nhận tiền chung.

Dễ dàng xác định giao dịch, hỗ trợ quá trình kiểm tra và đối soát dòng tiền.

Ngoài ra, dùng VA còn giúp bạn không phải chia sẻ số tài khoản chính cho từng khách, vì mỗi người chuyển vào một VA định danh riêng.

VA khác gì dùng một tài khoản nhận tiền chung?

Khác biệt lớn nhất là VA phân loại khoản thu ngay từ lúc tiền về, còn tài khoản chung buộc bạn phải đối chiếu thủ công sau đó. Bảng dưới đây so sánh theo từng tiêu chí.

Vì tiền vẫn dồn về tài khoản chính tại ACB, bạn có được cả hai: dòng tiền tập trung để quản lý và khả năng bóc tách từng nguồn thu để đối soát.

Các bước thêm tài khoản VA của ACB trên PionPay

Bước 1: Vào mục liên kết ngân hàng

Chọn "Tài khoản ảo (VA)"

Bước 2: Đặt tên gợi nhớ cho tài khoản ảo (VA)

Bước 3: Xác nhận OTP để tạo VA

Bước 4: Hoàn tất tạo VA

Cần lưu ý gì khi dùng VA?

VA phải do ngân hàng hoặc đơn vị được ngân hàng cho phép cung cấp và dùng đúng mục đích sản phẩm. Việc mở và sử dụng tài khoản thanh toán tại Việt Nam được điều chỉnh bởi Thông tư 17/2024/TT-NHNN; pháp luật nghiêm cấm giả mạo danh tính, mua bán, cho thuê, cho mượn tài khoản thanh toán (Nguồn: FinanOne tổng hợp, 2026). VA trong tính năng này được tạo trên ACB thông qua kết nối của PionPay.

Câu hỏi thường gặp

VA có rút hay chuyển tiền đi được không?

Thông thường VA chỉ dùng để nhận tiền; khoản thu được ghi nhận về tài khoản chính tại ACB.

Tạo được bao nhiêu VA?

Bạn có thể tạo nhiều VA theo khách hàng, đơn hàng hoặc mục đích; giới hạn cụ thể xem trên PionPay hoặc theo quy định của ACB.

VA có giúp đối soát tự động không?

Có. Mỗi giao dịch gắn với một VA định danh nên được phân loại ngay khi tiền về.

Tiền vào VA có về tài khoản chính không?

Có. VA giúp nhận diện nguồn thu, tiền vẫn tập trung về tài khoản chính.

Bắt đầu tạo VA trên ACB cùng PionPay

Vào PionPay.vn để tạo tài khoản VA trên ACB, hoặc gọi hotline 0981.690.369 để được tư vấn triển khai phù hợp với mô hình của bạn.

OpenAPI banking

anh anh — Tue, 22 Sep 2026 04:57:02 +0000