Khách đến MONA làm phần mềm quản lý bán hàng thường hỏi cùng một câu, đó là làm sao để tích hợp cổng thanh toán VietQR vào phần mềm mà không phải thuê thêm người ngồi soát tiền dù shop chỉ có 16 đơn mỗi ngày. Nhiều anh chị tìm chữ “cổng thanh toán”, nhưng thứ phần mềm thật sự cần lại là một dịch vụ đọc tin nhắn ngân hàng rồi báo về hệ thống trong 2 giây. Tụi em gọi đúng tên. Đó là xác nhận chuyển khoản tự động, không phải cổng giữ tiền hộ ai. Qua 14.000+ dự án của cả tập đoàn, tụi em thấy phần này hay bị bỏ tới cuối cùng, dù nó quyết định phần mềm có được khách tin dùng lâu dài hay không.
Vì sao đối soát thủ công vẫn là điểm nghẽn của phần mềm bán hàng
Khách MONA hay kể chuyện kế toán ngồi dò từng dòng biến động số dư lúc 9 giờ tối để xem khoản 250.000 đồng vừa về là của đơn nào, trong khi phần mềm đã bán chạy và có hàng trăm đơn mỗi ngày. Khách quên ghi mã đơn, gõ sai một số, hoặc chuyển đúng tiền nhưng nội dung trống trơn, thế là tiền nằm im chờ người soát tay. Đừng để tình trạng đó kéo dài. Chỉ khi hệ thống tự đọc được tiền vào và tự khớp đúng đơn, phần mềm mới thật sự gọi là tự động, còn lại vẫn là excel núp dưới giao diện đẹp. Vấn đề càng lộ rõ khi phần mềm bán theo mô hình đăng ký định kỳ, vì mỗi tháng lại có một đợt đối soát mới chồng lên đợt trước mà nhân sự thì không tăng theo tốc độ đó. Càng nhiều khách dùng phần mềm cùng lúc, khối lượng đối soát càng phình theo cấp số nhân chứ không tăng đều đặn.
Cơ chế VietQR hoạt động ra sao trong một phần mềm thật
Khi khách bấm thanh toán, phần mềm gọi API sinh một mã VietQR động, mã này đã điền sẵn số tài khoản, số tiền và nội dung đơn hàng nên khách chỉ cần quét và bấm chuyển. Không gõ tay. Chuẩn VietQR do NAPAS vận hành cho mọi ngân hàng trong nước, khách dùng app ngân hàng nào cũng quét được. Ngay khi tiền về, MONA Pay bắt tín hiệu, ký gói dữ liệu bằng HMAC-SHA256 kèm header X-Mona-Signature, rồi bắn webhook về máy chủ của phần mềm trong vài giây, đúng cơ chế mà tụi em đã tự dùng cho chính hệ thống nội bộ từ 2022. Phần mềm nhận webhook, đối chiếu mã đơn, tự đổi trạng thái thành đã thanh toán mà không cần ai bấm tay. Toàn bộ dữ liệu gửi qua webhook đều ở dạng JSON có cấu trúc rõ ràng, nên lập trình viên chỉ cần đọc đúng trường amount và order_code là đủ để cập nhật đơn hàng của mình. Không cần dựng thêm một tiến trình nào để hỏi ngân hàng liên tục, phần mềm chỉ đứng đó chờ webhook gõ cửa. Cách làm này nhẹ hơn nhiều so với kiểu polling liên tục mà một số hệ thống cũ vẫn dùng để hỏi ngân hàng xem tiền đã về chưa.
Chỗ tụi em từng vấp khi đọc dữ liệu ngân hàng
Tụi em từng gặp một ngân hàng gửi thông báo giao dịch với phần header dồn sai vị trí so với tài liệu kỹ thuật, hệ thống chuẩn của tụi em nhận diện lỗi liền và trả về mã 422 rồi bỏ giao dịch đó trong chưa tới 2 giây. Ngân hàng không sửa theo ý mình được, nên tụi em phải tự viết một lớp đọc lại cho đúng cấu trúc rồi phát lại các giao dịch bị rớt cho khách. Hồi tháng 9/2026, tụi em còn dính một sự cố khác: cấu hình lại máy chủ làm rơi mất khoá bí mật của webhook, hệ thống vẫn bắn tín hiệu nhưng mang khoá rỗng, bên nhận trả về lỗi 401 vì không xác thực được. Đơn chưa cộng. Khách đã chuyển tiền mà đơn chưa cộng, tụi em phải mở lịch sử webhook trên my.monapay.vn, bổ sung lại khoá rồi bấm gửi lại hàng loạt. Từ đó tụi em luôn dặn khách bật cảnh báo khi tỉ lệ webhook thành công tụt xuống, đừng tin kiểu chạy được một lần là chạy mãi. Hai sự cố khác nhau về nguyên nhân, nhưng đều dạy tụi em cùng một bài học về việc phải lưu lịch sử để tra lại.
Khi nào lập trình viên nên tự nối API, khi nào chưa cần
Nếu shop của anh chị đang dưới 20–30 đơn mỗi ngày thì chưa cần bỏ công viết code tích hợp làm gì. Một link thu tiền tại pay.monapay.vn cộng con bot báo Telegram hoặc nhóm Zalo là đủ dùng, dựng trong 10 phút là xong việc. Đừng vội viết code lúc này. Khi đơn tăng lên vài trăm mỗi ngày, hoặc phần mềm cần tự mở dịch vụ ngay lúc tiền vào, lúc đó mới đáng để lập trình viên đọc tài liệu API và nối webhook thật, đúng như cách khách MONA làm phần mềm SaaS đang chạy. MONA Pay có sẵn plugin cho WooCommerce, app cho Shopify, module cho OpenCart 4 và PrestaShop 8, phần mềm tự viết thì dùng thẳng tài liệu tại monapay.vn/docs. Với những nền tảng chưa có plugin dựng sẵn, lập trình viên vẫn nối được qua REST API chuẩn, chỉ cần gọi đúng endpoint tạo giao dịch và xác thực chữ ký webhook theo tài liệu. Phần lớn thời gian tích hợp thực tế nằm ở việc đọc kỹ tài liệu chứ không phải viết code, vì logic gạch nợ vốn đã đơn giản khi dữ liệu về đúng chuẩn. Khách MONA từng tự nối xong trong một buổi chiều nhờ đọc đúng phần ví dụ mẫu trong tài liệu trước khi bắt tay viết.
Cái MONA Pay chưa làm được, tụi em nói thẳng
MONA Pay không nhận thẻ Visa hay Mastercard, cũng không nhận PayPal, chỉ xử lý chuyển khoản ngân hàng trong nước qua VietQR và tài khoản ảo, phản hồi trong 2 giây chứ không chờ tới vài phút như nhiều nơi vẫn làm. Nếu tệp khách của phần mềm anh chị chủ yếu trả bằng thẻ quốc tế thì tụi em chưa hợp, anh chị vẫn cần một cổng thẻ riêng cho phần đó, và MONA Pay chỉ đứng ở phần chuyển khoản trong nước chứ không cố ôm hết mọi hình thức thanh toán. Chưa hợp thì nói thẳng. Đây là ranh giới tụi em tự đặt ra, không phải để né việc mà để phần đã làm được chạy ổn định thật sự. Dưới 20–30 đơn mỗi ngày thì cũng chưa cần API này. Ngân hàng ACB đang chạy chính thức với tốc độ thời gian thực, các ngân hàng khác tụi em đang nối API báo có dần, chưa hứa ngày cụ thể cho từng ngân hàng.
Từ nội bộ MONA tới bản đóng gói cho phần mềm của anh chị
Tụi em tự xây hệ này từ năm 2022 để thu tiền cho chính MONA, tới nay đã 6.000+ khách mới thanh toán qua đó, năm 2026 mới đóng gói thành MONA Pay để chia sẻ ra ngoài. Gói miễn phí xử lý tới 500 giao dịch mỗi tháng, tức khoảng 16 đơn một ngày, vượt mức đó thì gói cố định từ 99.000 đồng mỗi tháng cho 2.000 giao dịch, không thu phần trăm trên số tiền ở bất kỳ gói nào. So với PayPal thu khoảng 4,4% cộng phí cố định trên mỗi giao dịch, một phần mềm bán hàng trong nước không cần trả mức phí đó. Rẻ hơn nhiều. Riêng khách đang thuê hosting, tên miền hoặc dùng phần mềm quản lý tại MONA thì được dùng MONA Pay miễn phí không giới hạn giao dịch, vì tụi em coi đó là dịch vụ đi kèm chứ không tính riêng. Đây cũng là cách tụi em trả ơn ngược lại cho khách đã gắn bó lâu với MONA từ những dự án phần mềm đầu tiên. Anh chị đăng ký tại my.monapay.vn, thử sandbox trước khi nối ngân hàng thật, hoặc gọi tổng đài 1900 636 648 để tụi em nối giúp phần webhook cho phần mềm order của anh chị.
Câu hỏi thường gặp
Tích hợp cổng thanh toán VietQR vào phần mềm mất bao lâu?
Với tài liệu API tại monapay.vn/docs, lập trình viên quen webhook và REST API thường xong phần nối trong khoảng 2 giờ, thử trên sandbox trước khi chạy thật.
Có bị thu phí trên mỗi giao dịch thành công không?
Không thu phần trăm ở mọi gói. Gói miễn phí xử lý 500 giao dịch mỗi tháng, trên mức đó là gói cố định từ 99.000 đồng mỗi tháng cho 2.000 giao dịch.
Phần mềm nhận webhook chậm có bị mất giao dịch không?
Webhook có lịch sử lưu trên my.monapay.vn kèm tỉ lệ thành công, thấy webhook lỗi thì bấm gửi lại, không cần lo mất dữ liệu giao dịch cũ. Mỗi lần gửi lại, hệ thống vẫn ký lại chữ ký HMAC-SHA256 mới nên phía nhận luôn xác thực được nguồn gốc dữ liệu.
Phần mềm đang dùng ngân hàng khác ACB thì sao?
Các ngân hàng khác tụi em đang nối dần và cập nhật trạng thái tại monapay.vn/ngan-hang, mất khoảng 2 giây để phần mềm nhận báo có khi ngân hàng đã chạy. ACB thì đã chạy rồi. Ngân hàng còn lại chưa hứa ngày cụ thể.
