Khách đến MONA làm phần mềm quản lý phân phối hay hỏi tụi em cùng một câu, làm sao định danh được dòng tiền từ hàng chục đại lý về một tài khoản mà không lẫn tiền của ai vào tiền của ai. Qua 14.000+ dự án của cả tập đoàn, tụi em thấy đa số doanh nghiệp vẫn dùng chung một số tài khoản cho mọi đại lý, rồi kế toán tự đoán khoản nào của ai dựa vào nội dung chuyển khoản hay ghi sai, dù khoản đó chỉ là 250.000 đồng. Đoán sai là mất công. MONA Pay không giữ tiền hộ, không phải ví trung gian, chỉ đọc thông báo ngân hàng rồi xác nhận đúng đại lý nào vừa trả, trong khoảng 2 giây kể từ lúc tiền về.
Khó khăn khi chưa định danh được dòng tiền từ đại lý
Khách MONA làm phân phối hay kể chuyện kế toán phải xin ảnh chụp màn hình chuyển khoản từ từng đại lý để đối chiếu công nợ cuối tháng, vì nội dung chuyển khoản ghi sai hoặc thiếu mã liên tục. Khách MONA từng kể một khoản 2.400.000 đồng về tài khoản chung mà không biết của đại lý nào, kế toán phải gọi điện hỏi từng người trong số hàng chục đại lý mới xác định được, mất gần 2 giờ chỉ cho một khoản tiền. Đừng để việc này kéo dài. Vào những ngày cuối tháng, khi hàng chục giao dịch dồn lại cùng lúc, việc gán nhầm tiền của đại lý A cho đại lý B xảy ra thường xuyên hơn tưởng tượng, kéo theo tranh cãi công nợ không đáng có. Chuyện này lặp lại đều đặn mỗi kỳ chốt sổ, chứ không phải một lần rồi thôi. Doanh nghiệp càng mở rộng chuỗi, số lần tranh cãi công nợ càng tăng theo cấp số nhân chứ không tăng đều.
Cơ chế tài khoản ảo giúp định danh từng đại lý
Mỗi đại lý được gắn một tài khoản ảo (VA) riêng thay vì dùng chung một số tài khoản công ty như trước, đúng cách tụi em đang vận hành cho các sản phẩm phân phối của khách MONA suốt 6 năm qua. Không lẫn tiền ai với ai. Khi đại lý chuyển khoản, tiền chảy thẳng vào tài khoản gốc của doanh nghiệp, nhưng hệ thống vẫn biết chính xác khoản đó đến từ tài khoản ảo nào, tức của đại lý nào. MONA Pay bắt tín hiệu này, 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ủ phần mềm quản lý trong khoảng 2 giây để tự động cập nhật công nợ. Số lượng tài khoản ảo tạo ra không giới hạn, nên chuỗi có vài trăm đại lý vẫn định danh được từng đại lý một cách rạch ròi. Toàn bộ dữ liệu gửi qua webhook ở dạng JSON có cấu trúc rõ ràng, lập trình viên chỉ cần đọc đúng trường amount và mã tài khoản ảo để cập nhật công nợ. Không cần dựng thêm 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. Luồng này được vẽ đủ từng bước ở trang phần mềm quản lý công nợ đại lý tự gạch nợ.
Chỗ tụi em từng vấp khi vận hành hệ thống định danh này
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, trả về mã 422 và bỏ giao dịch trong chưa tới 2 giây. Ngân hàng không sửa theo yêu cầu của một khách hàng đơn lẻ, 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. Một lần khác, hồi tháng 9/2026, cấu hình lại máy chủ làm rơi mất khoá bí mật của webhook. Tụi em mất khoá thật. Webhook vẫn bắn tín hiệu nhưng mang khoá rỗng, bên nhận trả về lỗi 401, đại lý đã chuyển tiền mà công nợ chưa được cập nhật. 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, và từ đó luôn dặn khách bật cảnh báo khi tỉ lệ webhook thành công tụt xuống.
Khi nào chuỗi nhỏ chưa cần nối API, khi nào nên làm
Nếu chuỗi phân phối của anh chị đang dưới 20–30 giao dịch mỗi ngày thì chưa cần bỏ công viết code tích hợp webhook làm gì, đây cũng là lời khuyên tụi em hay nói thẳng với khách MONA mới mở chuỗi. Một link thu tiền tại pay.monapay.vn cộng bot báo Telegram hoặc nhóm Zalo cho từng đại lý là đủ dùng, dựng trong 10 phút là xong việc. Đừng vội nối API lúc này. Khi số đại lý tăng lên vài chục, vài trăm, hoặc phần mềm cần tự động cập nhật công nợ 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. MONA Pay cung cấp bộ API mở, dùng chung được với phần mềm quản lý bán hàng online đang có sẵn, thời gian nối thường trong khoảng 2 giờ cho lập trình viên quen webhook. 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 cập nhật công nợ vốn đã đơn giản khi dữ liệu về đúng chuẩn. Với những nền tảng chưa có module dựng sẵn, lập trình viên vẫn nối được qua REST API chuẩn theo tài liệu tại monapay.vn/docs.
Cái MONA Pay chưa làm được cho mô hình đại lý, 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. Nếu đại lý của anh chị ở nước ngoài và quen trả bằng thẻ quốc tế, tụi em chưa hợp, anh chị vẫn cần một cổng thẻ riêng cho phần đó. Chưa hợp thì nói vậy. Dưới 20–30 giao dịch mỗi ngày thì cũng chưa cần API này, một link thu tiền là đủ trong 10 phút. MONA Pay chỉ đứng đúng một việc, xác nhận chuyển khoản trong nước trong khoảng 2 giây, không tự động xuất hoá đơn điện tử hay khoá mở kho hàng thay phần mềm của anh chị. 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. Ranh giới này tụi em tự đặt ra để phần đã làm chạy ổn định thật, không vẽ ra một hệ thống làm được mọi thứ trong khi chưa kiểm chứng hết. Khách MONA bán hàng ra nước ngoài vẫn cần một cổng thẻ song song, MONA Pay chỉ lo phần đại lý trong nước.
Từ hệ thống nội bộ MONA tới dịch vụ cho mọi chuỗi phân phối
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, đủ cho một chuỗi vài chục đại lý mới bắt đầu, còn 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 đại lý chuyển ở bất kỳ gói nào, khác hẳn việc bị trừ phí như PayPal thu khoảng 4,4% cộng phí cố định mỗi giao dịch. Rẻ hơn hẳn. 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 còn được dùng MONA Pay miễn phí không giới hạn giao dịch. Đây cũng là cách tụi em trả ơn ngược lại cho khách đã gắn bó từ những dự án phần mềm đầu tiên. Qua 14.000+ dự án cả tập đoàn đã triển khai, tụi em hiểu phần thu tiền phải chạy ổn định hơn bất kỳ tính năng nào khác trong phần mềm phân phối. 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 quản lý bán hàng online của anh chị.
Câu hỏi thường gặp
Hệ thống định danh dòng tiền cho chuỗi đại lý có an toàn không?
Có. Tiền chuyển thẳng vào tài khoản ngân hàng gốc của doanh nghiệp trong khoảng 2 giây, MONA Pay chỉ đọc tín hiệu báo có và cập nhật công nợ, không đứng giữa giữ tiền của ai.
Mỗi đại lý có cần một số tài khoản ngân hàng riêng không?
Không cần số tài khoản ngân hàng riêng. Mỗi đại lý chỉ cần một tài khoản ảo (VA) gắn với tài khoản gốc, tụi em tạo được không giới hạn số lượng cho từng chuỗi. Việc thêm hay bớt đại lý cũng không ảnh hưởng tới các tài khoản ảo đã cấp trước đó.
Thời gian tích hợp hệ thống này mất bao lâu?
Với tài liệu tại monapay.vn/docs, lập trình viên quen webhook thường xong phần nối trong khoảng 2 giờ, thử trên sandbox trước khi chạy thật với tiền thật.
Chuỗi đại lý đ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, cập nhật trạng thái tại monapay.vn/ngan-hang. ACB thì đã chạy ổn định. Ngân hàng còn lại chưa hứa ngày cụ thể.
