Cổng thanh toán MONA Pay là gì?
21 câu anh chị hay hỏi trước khi dùng

MONA Pay là cổng thanh toán và API ngân hàng của The MONA Group, giúp doanh nghiệp Việt Nam nhận và xác nhận tiền chuyển khoản theo thời gian thực qua tài khoản ảo (VA), VietQR, webhook và Telegram — thiết kế để cả lập trình viên lẫn AI agent tích hợp trong vài phút. Nói đơn giản: khách chuyển khoản vào tài khoản ACB của anh chị, ACB báo cho MONA Pay, MONA Pay báo ngay cho website, phần mềm hoặc nhóm Telegram của anh chị để đơn hàng tự xác nhận, không cần ai ngồi canh app ngân hàng.

Không. Tiền vào thẳng tài khoản ngân hàng đứng tên anh chị, MONA Pay không giữ tiền, không rút, không chuyển. Việc duy nhất MONA Pay làm là đọc thông báo giao dịch ACB gửi về rồi báo lại cho hệ thống của anh chị qua webhook, Telegram và dashboard. Tụi em không có mật khẩu ngân hàng của anh chị; việc nối tài khoản xác thực bằng 2 lần OTP do ACB gửi về số điện thoại anh chị đã đăng ký.

MONA Pay là sản phẩm của The MONA Group, công ty làm web và phần mềm từ 2016 với 14.000+ dự án và 85% khách quay lại. Hệ thống này tụi em tự xây để thu tiền cho chính MONA (phí hosting mona.host, học phí Khánh Hùng Academy, đơn hàng Mona.Software), rồi từ 2022 tới nay hơn 6.000 khách hàng mới của MONA đã thu tiền qua đây trong web, phần mềm tụi em giao. Năm 2026 mới mở public tại monapay.vn cho mọi doanh nghiệp.

App ngân hàng báo cho người đọc, MONA Pay báo cho phần mềm. Khi tiền vào, MONA Pay gửi một bản tin JSON (gọi là webhook) tới website hoặc phần mềm của anh chị ngay khi ACB thông báo, để đơn hàng tự chuyển sang trạng thái đã thanh toán. Thêm nữa, mỗi đơn hoặc mỗi khách có thể được cấp một số tài khoản ảo (VA) riêng, nên tiền vào số nào là biết đơn nào, không phụ thuộc khách gõ đúng nội dung chuyển khoản.

Mỗi webhook được ký HMAC-SHA256 kèm dấu thời gian, hệ thống của anh chị từ chối bản tin lệch quá 5 phút để chặn gửi lại giả mạo. Gọi API cần token đăng nhập cộng thêm client secret riêng, dashboard có xác thực 2 lớp. MONA Pay chỉ ghi nhận đúng những gì ACB gửi về cho một giao dịch: số tiền, nội dung, thời gian, mã giao dịch, số tài khoản nhận. Không có quyền chuyển tiền, không có mật khẩu ngân hàng.

Nếu đã có lập trình viên, phần việc gói trong 3 điểm: tạo một địa chỉ nhận POST JSON, kiểm tra chữ ký HMAC, trả HTTP 200 trong vòng 10 giây. Tụi em có sẵn code mẫu cURL, PHP và Node, dán vào là chạy, nên thường mất vài phút tới một buổi tuỳ hệ thống. Nếu anh chị làm web tại MONA thì đội kỹ thuật cài luôn, không cần tự làm.

Webhook là cách MONA Pay chủ động gọi sang website của anh chị mỗi khi có tiền vào, thay vì website phải hỏi đi hỏi lại. Website chỉ cần mở một địa chỉ nhận dữ liệu (ví dụ https://web-cua-anh-chi.vn/webhook/monapay), đọc 7 trường trong bản tin (số tiền, nội dung, thời gian, mã giao dịch, số tài khoản nhận, ngân hàng, loại giao dịch), rồi cập nhật đơn hàng. Anh chị đăng ký địa chỉ này trong dashboard mục Webhooks, có nút gửi thử để kiểm tra ngay.

Không mất. Giao dịch luôn nằm trong dashboard và tra được qua API bất kể webhook có tới nơi hay không. MONA Pay coi là gửi thành công khi hệ thống anh chị trả HTTP 200, 201 hoặc 202 trong 10 giây; nếu không, lần gửi được ghi log với nhãn lỗi cụ thể (hết giờ, lỗi SSL, lỗi DNS, HTTP 5xx...) và anh chị bấm gửi lại từ dashboard. Gửi lại tự động theo lịch, tối đa 7 lần, đang được tụi em triển khai và sẽ công bố lịch cụ thể trong tài liệu. Mã giao dịch không đổi qua các lần gửi, nên hệ thống của anh chị dùng nó làm khoá chống ghi trùng.

Được, và tụi em thiết kế cho đúng việc đó. Toàn bộ tài liệu có bản máy đọc: /llms.txt liệt kê mọi trang, mỗi trang tài liệu có bản .md, và /openapi.json mô tả API. Trong dashboard có khối prompt sao chép sẵn, dán vào agent là nó tự viết phần nhận webhook và kiểm tra chữ ký. Một việc vẫn cần người: OTP nối ACB phải nhập từ điện thoại của anh chị; còn đăng ký tài khoản, lấy key, cấu hình webhook thì agent tự làm hết qua API, không cần ai duyệt. Chi tiết tại trang dành cho AI agent.

Có. API v1 gồm tạo và huỷ mã VietQR động theo đơn hàng (số tiền, mã đơn, nội dung), đăng ký tài khoản ảo, tra danh sách giao dịch theo trang (tối đa 100 giao dịch một lần gọi), cấu hình webhook và Telegram. Mọi phản hồi cùng một khung: success, message, data. Đăng nhập lấy token Bearer, thao tác ghi kèm thêm client secret riêng. Tài liệu tại /docs.

Plugin MONA Pay cho WooCommerce đang được xây, chưa có trên kho wordpress.org. Hiện có 2 đường: khách làm web tại MONA thì đội kỹ thuật nối sẵn; còn web tự làm thì lập trình viên tạo một endpoint PHP nhận webhook theo code mẫu (khoảng 30 dòng) rồi cập nhật trạng thái đơn. Hướng dẫn riêng tại /cong-thanh-toan-woocommerce.

Hai cổng đó sinh ra để nhận tiền từ nước ngoài. PayPal Việt Nam thu 4,40% cộng phí cố định theo tiền tệ cho giao dịch thương mại từ ngoài lãnh thổ Việt Nam, tiền nằm trong ví PayPal, rút về ngân hàng Việt Nam mất 60.000đ mỗi lần khi không quy đổi tiền tệ, rút lỗi bị trả lại mất thêm 70.000đ (biểu phí chính thức, tụi em kiểm ngày 28/08/2026). Stripe chưa mở đăng ký cho doanh nghiệp tại Việt Nam (trang quốc gia hỗ trợ của Stripe ngày 28/08/2026 có Singapore, Thái Lan, Malaysia, Indonesia, không có Việt Nam). Khách trong nước quen quét VietQR và chuyển khoản, nên MONA Pay làm đúng việc đó: tiền vào thẳng tài khoản ACB của anh chị, miễn phí hoàn toàn, không giới hạn giao dịch.

Dùng song song, không mâu thuẫn. Khách nước ngoài trả bằng thẻ hoặc USD thì đi PayPal, khách trong nước chuyển khoản thì đi MONA Pay. Đơn nội địa được webhook MONA Pay xác nhận tự động, đơn quốc tế theo thông báo của PayPal. Nhiều khách MONA làm web bán hàng chạy đúng kiểu này.

MONA Pay không nhận thẻ Visa, Mastercard của khách nước ngoài và không đổi ngoại tệ. MONA Pay chỉ làm một việc: xác nhận tiền chuyển khoản nội địa theo thời gian thực rồi báo về web, phần mềm, Telegram. Bảng so chi tiết từng hạng mục ở so với cổng thanh toán quốc tế.