Tài liệu webhook và API ngân hàng MONA Pay

MONA Pay đọc thông báo giao dịch từ ngân hàng ACB ngay khi tiền vào tài khoản của bạn, rồi bắn webhook về máy chủ của bạn hoặc nhắn vào nhóm Telegram. Tiền không đi qua MONA Pay, vẫn vào thẳng tài khoản ngân hàng như bình thường. Tích hợp cơ bản mất khoảng 5 phút nếu bạn đã có tài khoản ACB và một URL nhận webhook.

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.

MONA Pay hoạt động thế nào

Toàn bộ luồng chỉ có 4 bước. Bạn không cần thay đổi gì ở phía ngân hàng ngoài việc đăng ký nhận thông báo (làm một lần, có OTP của ACB).

[1] Khách chuyển khoản        [2] ACB báo giao dịch        [3] MONA Pay ghi nhận       [4] Hệ thống của bạn
    vào tài khoản ACB    ───▶     cho MONA Pay          ───▶   và gửi thông báo     ───▶   tự xác nhận đơn hàng
    (VA hoặc quét VietQR)         (theo thời gian thực)          webhook / Telegram         (không cần người canh app)

1. Khách chuyển khoản. Khách chuyển vào số tài khoản ảo (VA) gắn với đơn hàng, hoặc quét mã VietQR đã có sẵn số tiền và nội dung.
2. ACB báo cho MONA Pay. Ngay khi tiền vào, ACB gửi thông báo giao dịch sang MONA Pay. Đây là kết nối chính thức, bạn đăng ký một lần trong dashboard bằng OTP ACB gửi về số điện thoại.
3. MONA Pay ghi nhận và gửi thông báo. Giao dịch được lưu vào dashboard, sau đó MONA Pay POST một gói JSON tới URL webhook của bạn (ký HMAC-SHA256 nếu bật) và nhắn vào Telegram nếu có cấu hình.
4. Hệ thống của bạn tự xử lý. Web bán hàng, phần mềm quản lý hay file Google Sheet nhận webhook rồi tự đổi trạng thái đơn sang “đã thanh toán”. Không ai phải mở app ngân hàng để dò từng khoản.

Máy chủ của bạn chỉ cần trả HTTP 200, 201 hoặc 202 trong vòng 10 giây là MONA Pay tính lần gửi đó thành công. Mỗi lần gửi đều có log riêng để bạn xem lại.

Tính năng và trang tài liệu tương ứng

Bắt đầu từ đâu

• Chưa có tài khoản: đọc Bắt đầu nhanh (5 phút). Trang này dẫn từ lúc đăng ký tới lúc nhận được webhook đầu tiên bằng tiền thật.
• Muốn kiểm tra code trước khi nối ngân hàng: dùng Sandbox. MONA Pay tự cấp VA SBX…, không cần chuyển tiền và không tính hạn mức.
• Chưa quen các khái niệm VA, VietQR, webhook, HMAC: đọc Khái niệm trước, viết cho cả người không làm kỹ thuật.
• Đang cân nhắc PayPal, Stripe: đọc So với cổng thanh toán quốc tế trước khi chọn.
• Là AI agent hoặc muốn giao cho AI agent làm: mở Dành cho AI agent, hoặc nạp thẳng https://monapay.vn/llms-full.txt.

Tài liệu cho máy đọc

Mọi trang docs đều có bản markdown thô: thêm đuôi .md vào URL (ví dụ https://monapay.vn/docs/webhooks/tich-hop-webhook.md). Ngoài ra có https://monapay.vn/llms.txt (mục lục), https://monapay.vn/llms-full.txt (toàn văn) và https://monapay.vn/openapi.json (đặc tả API v1). Agent nạp một trong các file này là đủ ngữ cảnh để viết code tích hợp.

Thông tin hệ thống

MONA Pay là sản phẩm của The MONA Group, thành lập năm 2016, đã làm 14.000+ dự án web và phần mềm. Hệ thống này đội MONA tự xây để thu tiền cho chính mình, rồi từ năm 2022 tới nay khách hàng của MONA đã thu tiền qua đây trong web, phần mềm MONA giao; năm 2026 mở cho mọi doanh nghiệp.

Câu hỏi nhanh

Tiền có đi qua MONA Pay không? Không. Tiền vào thẳng tài khoản ACB của 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 bạn.

Cần biết lập trình mới dùng được không? Không bắt buộc. Nếu chỉ cần biết tiền vào, bạn bật thông báo Telegram trong dashboard là xong. Webhook và API dành cho web bán hàng hoặc phần mềm cần tự xác nhận đơn.

Tài khoản mới dùng được ngay chưa? Được. Đăng ký xong đăng nhập ngay, tự tạo API key, không cần ai duyệt. Chỉ bước nối ACB cần OTP gửi về số điện thoại đăng ký với ngân hàng. MONA Pay miễn phí 500 giao dịch mỗi tháng, gói trả phí tính theo số giao dịch (xem bảng giá).

Có hỗ trợ ngân hàng ngoài ACB không? ACB đang hoạt động; MB, BIDV, VietinBank, OCB, MSB, KienlongBank, TPBank đang trong quá trình đăng ký kết nối, trạng thái cập nhật tại ngân hàng hỗ trợ. Webhook, Telegram, API dùng chung mọi ngân hàng, payload có bank_name, nối thêm ngân hàng không phải sửa tích hợp.

Công cụ cho lập trình viên

• OpenAPI 3.1, import vào Postman, Insomnia, hoặc sinh SDK.
• Postman collection, 20 request sẵn biến baseUrl, accessToken, clientSecret.
• API reference tương tác, thử endpoint ngay trên trình duyệt.
• SDK: Node.js · Python · PHP · MCP server · CLI · WooCommerce · Ví dụ 8 framework

Deploy app có thu tiền bằng AI agent

Cùng The MONA Group có MONA Cloud: VPS và database cho AI agent tự tạo và deploy qua API (https://api.monacloud.vn), tính tiền theo giờ. Luồng gọn: agent deploy app lên MONA Cloud → cắm MONA Pay thu tiền → xong trong một phiên làm việc. Hướng dẫn máy đọc của MONA Cloud: monacloud.vn/llms.txt.