MONA Pay (monapay-mcp)
Банковский API Вьетнама для AI-агентов: создание VietQR-кодов, подтверждение входящих банковских переводов, настройка и тестирование вебхуков, проверка HMAC-подписей, отправка уведомлений по email и Zalo.
Документация

Thứ Năm, 17 tháng 909:26
Nhóm chốt đơn MONA Pay: tiền vào +2.500.000đ, DH2034
Nhóm Zalo cửa hàng ACB báo có 2.500.000đ
Email kế toán Tiền vào tài khoản ACB
200
Website của bạn Đơn DH2034 đã thanh toán
-
Claude Code
-
Cursor
-
Codex
Cài MCP cho AI agent monapay-mcp trên GitHub

Ảnh chụp trang pay.monapay.vn trong phiên sandbox của cửa hàng thử Không cần đăng nhập Webhook CHECKOUT_PAID Tự về cửa hàng Xem tài liệu

Ảnh chụp mục Lịch sử và giám sát webhook trên my.monapay.vn HMAC-SHA256 Chống gửi lại quá 5 phút Gửi lại từ dashboard Xem tài liệu

Ảnh chụp cửa hàng WooCommerce thử cài plugin MONA Pay WooCommerce OpenCart PrestaShop Shopify, Haravan, Sapo Xem tài liệu

Ảnh chụp mục API Keys trên my.monapay.vn client_id + client_secret Xoay secret khi cần Dùng cho MCP Xem tài liệu

Ảnh chụp mục Hướng dẫn tích hợp trên my.monapay.vn Website tự code Chưa có website Giao cho AI agent Xem tài liệu
- Token tự làm mới SDK đổi client_id, client_secret ra Bearer token, cache tới gần hạn và lấy lại khi gặp 401.
- Chữ ký kiểm sẵn verifyWebhook kiểm HMAC-SHA256 so sánh constant-time, từ chối timestamp lệch quá 300 giây.
- Không xử lý trùng transaction_code giữ nguyên qua các lần gửi lại, đặt unique là mỗi giao dịch chỉ cập nhật đơn một lần.
- Máy đọc được OpenAPI 3.1 và Postman collection cho mọi endpoint, mã nguồn mở trên GitHub The MONA Group.
Công cụ mã nguồn mở trên GitHub
- CLI monapay npm @monapay/cli: tạo QR, tra giao dịch, nghe webhook tại máy
- MCP server npm monapay-mcp cho Claude Code, Cursor, Codex
- Lớp tích hợp nền tảng Shopify, Haravan, Sapo, KiotViet, Nhanh.vn, WooCommerce
- Plugin WooCommerce VietQR và đơn tự xác nhận cho WooCommerce
- Google Sheets Apps Script kéo giao dịch về Sheet để đối soát
- VS Code Snippet webhook, tạo QR, xem giao dịch; mã nguồn
- Chrome, Edge Xem giao dịch, tạo VietQR nhanh; mã nguồn
- Zalo Mini App Mẫu thu tiền VietQR trong Zalo; mã nguồn
Những gì AI agent đọc được
/llms.txtMục lục mọi trang kèm tóm tắt, AI đọc trước để biết cần mở trang nào./llms-full.txtToàn văn tài liệu gom trong một file, đọc một lần là đủ ngữ cảnh./docs/….mdMọi trang tài liệu có bản markdown thô, thêm.md vào cuối URL là có./openapi.jsonĐặc tả OpenAPI 3.1 cho mọi endpoint, AI sinh request đúng trường.monapay-mcpMCP server có 50 công cụ: tạo link thu tiền, VietQR, webhook, sandbox, nối ngân hàng. Mã nguồn trên GitHub.
AI dừng lại hỏi bạn ở hai mã OTP ACB gửi về điện thoại khi nối ngân hàng và mã xác minh email, không tự đoán mã.
Claude Code
Claude Code · chạy trong terminal
claude mcp add --transport http monacloud https://mcp.monacloud.vn/mcp
Claude.ai · người bấm trong Settings → Connectors
Name: MONA Cloud
URL: https://mcp.monacloud.vn/mcp
[mcp_servers.monacloud]
url = "https://mcp.monacloud.vn/mcp"
Gemini (Antigravity) · chạy trong terminal
agy mcp add monacloud https://mcp.monacloud.vn/mcp
{ "mcpServers": { "monacloud": { "url": "https://mcp.monacloud.vn/mcp" } } }
Giao thẳng cho AI tự cài
Cài MCP MONA Cloud giúp tôi rồi kiểm tra chạy được chưa. Nếu bạn là Claude Code: chạy \`claude mcp add --transport http monacloud https://mcp.monacloud.vn/mcp\`. Nếu là Codex: thêm \`[mcp_servers.monacloud]\` với \`url = "https://mcp.monacloud.vn/mcp"\` vào \`~/.codex/config.toml\`. Nếu là Gemini/Antigravity: chạy \`agy mcp add monacloud https://mcp.monacloud.vn/mcp\`. Cài xong gọi thử \`cloud_domain_search\` với tên tôi muốn mua rồi báo giá cho tôi.
- Tạo link thu 250.000đ cho đơn DH10234 và chạy ở sandbox.
- monapay_create_checkout amount: 250000, order_code: "DH10234", sandbox: true
- checkout_url: https://pay.monapay.vn/c/…
- Tạo webhook HMAC cho shop này, bắn thử và kiểm tra log giúp tôi.
- monapay_generate_webhook_snippet
- monapay_create_webhook
- monapay_test_webhook
- monapay_webhook_logs
- HTTP 200. Webhook đã nhận payload thử, chữ ký hợp lệ.
-
Miễn phí
Hợp khi bán đều khoảng 16 đơn chuyển khoản mỗi ngày Free Đăng ký xong dùng ngay, không cần ai duyệt 500 giao dịch tiền vào mỗi tháng- Đủ mọi tính năng
- Vượt mức vẫn ghi nhận giao dịch, tháng sau cần nâng gói để tiếp tục báo
- Đủ mọi tính năng
-
Khởi nghiệp
Hợp khi bán đều khoảng 66 đơn chuyển khoản mỗi ngày 99.000đ /tháng 990.000đ /năm Tiết kiệm 198.000đ khi trả năm 2.000 giao dịch tiền vào mỗi tháng- Đủ mọi tính năng
- Vượt mức không bị khoá, phần vượt tính phụ trội 100 đ mỗi giao dịch
- Đủ mọi tính năng
- Nên chọn Shop đang lớn
Kinh doanh
Hợp khi bán đều khoảng 333 đơn chuyển khoản mỗi ngày 299.000đ /tháng 2.990.000đ /năm Tiết kiệm 598.000đ khi trả năm 10.000 giao dịch tiền vào mỗi tháng- Đủ mọi tính năng
- Vượt mức không bị khoá, phần vượt tính phụ trội 50 đ mỗi giao dịch
- Đủ mọi tính năng
-
Doanh nghiệp
Hợp khi bán đều khoảng 1.666 đơn chuyển khoản mỗi ngày 799.000đ /tháng 7.990.000đ /năm Tiết kiệm 1.598.000đ khi trả năm 50.000 giao dịch tiền vào mỗi tháng- Đủ mọi tính năng
- Vượt mức không bị khoá, phần vượt tính phụ trội 30 đ mỗi giao dịch
- Đủ mọi tính năng
-
Quy mô lớn
Hợp khi bán đều khoảng 10.000 đơn chuyển khoản mỗi ngày 1.990.000đ /tháng 19.900.000đ /năm Tiết kiệm 3.980.000đ khi trả năm 300.000 giao dịch tiền vào mỗi tháng- Đủ mọi tính năng
- Vượt mức không bị khoá, phần vượt tính phụ trội 15 đ mỗi giao dịch
- Đủ mọi tính năng
Mọi gói đều có
- Tài khoản ảo và VietQR động theo đơn
- Webhook có chữ ký, Telegram, Zalo, email
- Trang thanh toán gửi link là thu tiền
- API, SDK, MCP cho AI agent, sandbox
- Không thu phần trăm trên số tiền khách chuyển
- Tiền vào thẳng tài khoản ngân hàng của bạn

Khách hàng của MONA dùng miễn phí hoàn toàn. Bạn đang dùng web, phần mềm hay hosting của The MONA Group thì MONA Pay không giới hạn giao dịch trong suốt thời gian còn là khách. Gọi 1900 636 648 để đội MONA gán gói.
So với cổng thanh toán quốc tế. PayPal thu 4,40% cộng phí cố định mỗi giao dịch, rút về ngân hàng Việt Nam thêm 60.000đ mỗi lần (kiểm 28/08/2026). Cổng quốc tế hợp để nhận thẻ từ khách nước ngoài, còn nhận chuyển khoản trong nước thì dùng MONA Pay là đủ.
Xem bảng giá đầy đủ So với cổng thanh toán quốc tế
Chuyện MONA
The MONA Group đứng sau MONA Pay, làm web và phần mềm từ 2016
14.000+
dự án đã giao cho khách hàng
85%
khách làm xong quay lại làm tiếp với MONA
- 2016
The MONA Group bắt đầu bằng làm website cho doanh nghiệp
Làm web thì khách hỏi tiếp phần mềm quản lý, rồi hỏi chỗ đặt web cho ổn định. Ba mảng đó thành Mona.Media, Mona.Software và Mona.Host. - 2022
Hệ thống xác nhận chuyển khoản chạy trong web và phần mềm giao cho khách
MONA viết hệ thống này để tự thu phí hosting, học phí, đơn phần mềm trước, rồi nhúng vào web và phần mềm giao cho khách hàng của MONA. - 2026
Đặt tên MONA Pay và mở tại monapay.vn cho mọi doanh nghiệp
Miễn phí 500 giao dịch mỗi tháng. Gọi 1900 636 648 là gặp đúng đội đã làm việc này nhiều năm.
Chuyện MONA Pay mở cho mọi doanh nghiệp Khách hàng và ca dùng thật

Đội web, đội phần mềm và đội hosting ngồi chung một sàn văn phòng.

Đội viết và trực hệ thống MONA Pay.

Buổi làm việc tại văn phòng khách hàng.
[
Gấu MONA mở cửa đón mọi người vào, minh hoạ MONA Pay mở cho mọi doanh nghiệp
Tin MONA Pay 29/08/2026 MONA Pay mở cho mọi doanh nghiệp sau 4 năm phục vụ khách hàng của MONA Hệ thống nhận tiền chuyển khoản đội MONA tự xây để thu hosting, học phí, phần mềm, khách hàng của MONA dùng từ 2022, nay mở cho mọi doanh nghiệp.](https://monapay.vn/blog/mona-pay-mo-public-sau-4-nam)
Nghiên cứu
- 06/09/2026 Website vừa và lớn có bao nhiêu giao dịch mỗi tháng và trả bao nhiêu cho cổng thanh toán
- 06/09/2026 Bán trên sàn hay website riêng: doanh nghiệp mất bao nhiêu phần trăm doanh thu cho trung gian
- 05/09/2026 Chi phí nhận tiền của doanh nghiệp Việt Nam 2026: thẻ, ví, cổng quốc tế và chuyển khoản
- 05/09/2026 Bản đồ Open API ngân hàng Việt Nam 2026: ngân hàng nào mở, mở gì, đăng ký thế nào Xem tất cả nghiên cứu
Blog
Blog 29/08/2026 Xác nhận thanh toán tự động khi khách chuyển khoản hoạt động ra sao
Blog 29/08/2026 Webhook là gì? Hiểu bằng ví dụ tiền vào tài khoản ngân hàng
Blog 29/08/2026 VietQR là gì? Mã QR điền sẵn số tiền và nội dung hoạt động ra sao
Blog 29/08/2026 Tài khoản ngân hàng ảo là gì? Vì sao mỗi đơn một số thì tiền tự khớp
Blog 29/08/2026 Báo có tự động: tiền vào tài khoản là cả công ty biết
Blog 29/08/2026 Tích hợp cổng thanh toán vào website: ba cách và nên chọn cách nào
Blog 29/08/2026 Cổng thanh toán cho website bán hàng: ví, VNPAY hay VietQR?
Blog 29/08/2026 Cổng thanh toán miễn phí cho website: miễn phí thật khác miễn phí mở tài khoản
Blog 29/08/2026 Vì sao MONA Pay miễn phí 500 giao dịch mỗi tháng và không thu phần trăm
Blog 29/08/2026 Open banking là gì? Ngân hàng mở API thì doanh nghiệp nhỏ được gì
Blog 29/08/2026 API ngân hàng là gì? Phần mềm nói chuyện với ngân hàng bằng cách nào
Blog 29/08/2026 Nhận thanh toán từ nước ngoài và thu tiền Việt: hai đường tiền, hai cách làm
Blog 29/08/2026 Tự động xác nhận thanh toán hosting: đội MONA tự xây hệ thống thu tiền
Hỏi nhanh
Câu hỏi thường gặp trước khi dùng MONA Pay
Chưa thấy câu bạn cần thì gọi tổng đài MONA 1900 636 648 Xem tất cả câu hỏi
Tôi không rành kỹ thuật, tự dùng MONA Pay được không?
Được. Phần nhận báo có qua Telegram hay nhóm Zalo không cần viết dòng code nào: tạo tài khoản, nối ngân hàng bằng hai mã OTP, thêm bot vào nhóm, khoảng 10 phút. Phần tích hợp vào website thì lập trình viên làm một lần theo code mẫu. Kẹt chỗ nào gọi 1900 636 648.
Tiền của khách có đi qua MONA Pay không?
Không. Khách chuyển thẳng vào tài khoản ngân hàng đứng tên bạn. MONA Pay chỉ nhận thông báo giao dịch từ ngân hàng rồi báo lại cho phần mềm, nhóm Telegram, email và dashboard, nên không có chuyện chờ đối soát rồi mới được rút.
MONA Pay miễn phí thật không, có phí ẩn không?
Miễn phí 500 giao dịch tiền vào mỗi tháng, đủ mọi tính năng. Vượt mức đó có gói trả phí tính theo số giao dịch, niêm yết ở trang bảng giá, không thu phần trăm trên số tiền. Khách hàng của MONA (web, phần mềm, hosting) được miễn phí hoàn toàn.
Cần tài khoản ngân hàng nào?
ACB đang hoạt động với tài khoản ảo và báo có theo thời gian thực, tài khoản cá nhân hay doanh nghiệp đều nối được. Các ngân hàng khác có trạng thái cập nhật ở trang ngân hàng hỗ trợ. Webhook, Telegram, Zalo, email dùng chung cho mọi ngân hàng nên thêm ngân hàng không phải làm lại tích hợp.
Tôi chỉ bán qua Facebook, Zalo, chưa có website thì dùng được không?
Được. Bạn chỉ cần tài khoản ngân hàng và một nhóm Telegram hoặc nhóm Zalo: tiền vào là nhóm có tin. Cần mã QR đúng số tiền cho từng đơn thì tạo trong dashboard hoặc dùng công cụ tạo mã QR ngân hàng miễn phí trên monapay.vn.
Website của tôi không do MONA làm, có tích hợp được không?
Được. MONA Pay báo cho website bằng một gói tin HTTP tới đường dẫn bạn chỉ định, phần mềm nào nhận được yêu cầu từ internet là tích hợp được: WordPress, WooCommerce, Laravel, Node,.NET hay phần mềm nội bộ tự viết. Tài liệu có code mẫu để copy.
Website đang tắt lúc tiền vào thì có mất giao dịch không?
Không mất. Mọi giao dịch ngân hàng báo về đều được ghi trong dashboard, kể cả khi website đang tắt. Mỗi lần gửi tin về website đều có lịch sử, gửi hụt thì bấm gửi lại ngay trong dashboard.

Bắt đầu với MONA Pay
Nối ngân hàng hôm nay để đơn chuyển khoản tự xác nhận
Tạo tài khoản là dùng ngay, nối ACB bằng hai mã OTP, thêm bot vào nhóm Telegram hoặc nhóm Zalo là có tin báo có. Muốn thử trước thì sandbox tạo giao dịch tiền vào giả, không tốn tiền thật.
Miễn phí 500 giao dịch
- Free 500 giao dịch tiền vào mỗi tháng
- 99.000đ gói Khởi nghiệp, tới 2.000 giao dịch mỗi tháng
- 1900 636 648 tổng đài MONA