Hỏi đáp

Những câu bạn hay hỏi về MONA Pay trước khi dùng

Mỗi câu trả lời ngắn, có số cụ thể, đủ để bạn quyết: tiền đi đâu, ngân hàng nào, tích hợp mất bao lâu, giá bao nhiêu, và PayPal hay Stripe có hợp thu tiền trong nước không.

Cơ bản

MONA Pay là gì, tiền có đi qua không?

MONA Pay là gì?

MONA Pay là API ngân hàng và dịch vụ xác nhận thanh toán tự độ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 bạn, ACB báo cho MONA Pay, MONA Pay báo ngay cho website, phần mềm hoặc nhóm Telegram của bạn để đơn hàng tự xác nhận, không cần ai ngồi canh app ngân hàng.

Tiền của tôi có đi qua MONA Pay không?

Không. Tiền vào thẳng tài khoản ngân hàng đứng tên bạn, 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 bạn qua webhook, Telegram và dashboard. Đội MONA không có mật khẩu ngân hàng của bạn; 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 bạn đã đăng ký.

Ai đứng sau MONA Pay, có mới không?

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 đội MONA 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 khách hàng của MONA đã thu tiền qua đây trong web, phần mềm đội MONA giao. Năm 2026 mới mở public tại monapay.vn cho mọi doanh nghiệp.

MONA Pay khác gì app ngân hàng báo biến động số dư?

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 bạn 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.

Dữ liệu giao dịch của tôi được bảo vệ thế nào?

Mỗi webhook được ký HMAC-SHA256 kèm dấu thời gian, hệ thống của bạn 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.

Ngân hàng

Hỗ trợ ngân hàng nào, nối ACB ra sao?

MONA Pay hỗ trợ ngân hàng nào?

MONA Pay nhận báo có từ nhiều ngân hàng, gồm ACB, BIDV, VietinBank, MBBank, OCB, MSB và nhiều ngân hàng khác, cả tài khoản cá nhân lẫn doanh nghiệp. Bảng trạng thái từng ngân hàng nằm tại trang ngân hàng hỗ trợ, đổi sang đang hoạt động là nối được ngay. Webhook, Telegram, API dùng chung cho mọi ngân hàng nên nối thêm sau không phải sửa tích hợp. Cần nhận ngay hôm nay mà chưa có ACB, mở một tài khoản ACB online rồi nối là dùng.

Nối tài khoản ACB mất bao lâu, cần chuẩn bị gì?

Cần 2 thứ: tài khoản ACB đứng tên bạn (cá nhân hoặc doanh nghiệp) và số điện thoại đã đăng ký với ACB để nhận OTP. Trong dashboard, bạn đi 4 bước: nhập số tài khoản và số điện thoại, nhập OTP lần 1 để tạo tài khoản ảo, đăng ký nhận thông báo giao dịch, nhập OTP lần 2. Toàn bộ mất vài phút, không cần ra quầy.

Tài khoản ảo (VA) là gì, tại sao cần?

Tài khoản ảo là số tài khoản phụ do ACB cấp theo đầu số bạn đăng ký, tiền chuyển vào đó vẫn nằm trong tài khoản ACB thật của bạn. Cái hay là bạn có thể gắn mỗi đơn hàng hoặc mỗi khách hàng một số VA riêng: tiền vào số nào, hệ thống biết ngay đơn nào, không phụ thuộc khách có gõ đúng nội dung chuyển khoản hay không. Với mã VietQR động, khách quét là số tiền và số VA điền sẵn, gần như không có chuyện chuyển sai.

Khách chuyển sai số tiền hoặc sai nội dung thì sao?

MONA Pay báo đúng số tiền thực nhận và nội dung khách gõ, kèm mã giao dịch của ngân hàng. Nếu khách chuyển vào đúng số VA của đơn thì hệ thống vẫn nhận ra đơn đó dù nội dung sai; số tiền lệch thì website của bạn tự quyết định: đánh dấu đơn thiếu tiền, hoặc báo cho kế toán xử lý. Toàn bộ giao dịch đều xem lại được trên dashboard, có lọc theo ngày.

Tích hợp

Tích hợp vào web, phần mềm và AI agent thế nào?

Tích hợp MONA Pay vào website mất bao lâu?

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. Đội MONA 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 bạn làm web tại MONA thì đội kỹ thuật cài luôn, không cần tự làm.

Webhook là gì, website của tôi phải làm gì?

Webhook là cách MONA Pay chủ động gọi sang website của bạn 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. Bạn đăng ký địa chỉ này trong dashboard mục Webhooks, có nút gửi thử để kiểm tra ngay.

Webhook gửi thất bại thì sao, có bị mất giao dịch không?

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 bạn 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à bạn 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 đội MONA 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 bạn dùng nó làm khoá chống ghi trùng.

AI agent như Claude Code, Codex, Cursor có tự tích hợp MONA Pay được không?

Được, và đội MONA 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 bạn; 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 để tự tạo mã QR, tra giao dịch không?

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.

Tôi dùng WordPress hoặc WooCommerce thì làm thế nào?

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.

Giá và hỗ trợ

Giá bao nhiêu, cần giúp thì gọi ai?

MONA Pay có miễn phí không?

Có. Gói Miễn phí cho 500 giao dịch mỗi tháng với đầy đủ tính năng: tài khoản ảo, VietQR, webhook, Telegram, API. Các gói trả phí tính theo số giao dịch mỗi tháng, niêm yết công khai tại /bang-gia.

Đăng ký xong dùng ngay được không?

Được. Bạn tạo tài khoản tại my.monapay.vn là dùng ngay, tài khoản tự kích hoạt, không cần ai duyệt. Sau đó bạn tự nối ACB (2 lần OTP từ ACB, vài phút), tự tạo API key và webhook trong dashboard. Cần người MONA là chỉ khi bạn muốn đội MONA làm thay phần tích hợp.

Cần hỗ trợ kỹ thuật thì liên hệ đâu?

Tổng đài 1900 636 648 trong giờ hành chính, có người trực, hoặc email [email protected]. Với ca tích hợp phức tạp, kỹ sư MONA làm việc trực tiếp với lập trình viên của bạn. Đội này là đội đã làm 14.000+ dự án web và phần mềm, không phải tổng đài đọc kịch bản.

So với cổng quốc tế

PayPal, Stripe có hợp thu tiền trong nước không?

PayPal hay Stripe có dùng để thu tiền khách trong nước được không?

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, đội MONA 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 bạn, miễn phí 500 giao dịch mỗi tháng.

Vừa bán trong nước vừa bán ra nước ngoài thì dùng gì?

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.

So với cổng thanh toán quốc tế thì MONA Pay thiếu gì?

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ế.

Hỏi trực tiếp

Chưa thấy câu của bạn thì hỏi thẳng đội MONA

Câu nào được hỏi nhiều, đội MONA bổ sung thẳng vào trang này. Lập trình viên cần chi tiết kỹ thuật thì đọc tài liệu tích hợp, mỗi trang đều có bản .md cho AI agent đọc.

Bắt đầu với MONA Pay

Hết thắc mắc rồi thì tạo tài khoản dùng thử

Đăng ký xong dùng ngay, không cần ai duyệt. Miễn phí 500 giao dịch mỗi tháng với đầy đủ tài khoản ảo, VietQR, webhook, Telegram, API.