API ngân hàng
API ngân hàng: để phần mềm tự biết khách đã chuyển tiền
API ngân hàng là đường để phần mềm đọc được thứ đang xảy ra trong tài khoản ngân hàng: ai vừa chuyển tiền vào, bao nhiêu, nội dung gì, lúc mấy giờ. Có đường đó thì website tự xác nhận đơn, phần mềm tự mở khoá tài khoản, kế toán khỏi ngồi canh biến động số dư. MONA Pay là API ngân hàng và dịch vụ xác nhận thanh toán tự động, ACB đang chạy chính thức, mã QR tạo được cho 29 ngân hàng Việt Nam: tiền vẫn vào thẳng tài khoản của bạn, MONA Pay chỉ đọc tin báo có rồi bắn về hệ thống của bạn qua webhook, Telegram, Zalo hoặc email.
- 500 giao dịchmiễn phí mỗi tháng, đủ mọi tính năng
- Không thu %trên số tiền khách chuyển
- Tiền về thẳngtài khoản ngân hàng đứng tên bạn
- Từ 2022chạy tiền thật cho khách MONA
Nói nhanh
API ngân hàng làm được gì cho phần mềm của bạn
Ngân hàng giữ tiền và ghi lại mọi lần tiền vào, tiền ra. Bình thường muốn biết khách đã chuyển chưa, bạn phải mở app ngân hàng nhìn bằng mắt. API ngân hàng là cách để phần mềm nhìn thay bạn: máy hỏi thẳng hệ thống ngân hàng, nhận về số tiền, nội dung chuyển khoản, mã giao dịch và thời điểm, rồi tự xử lý tiếp.
Cần phân biệt hai thứ hay bị gộp làm một. API ngân hàng là đọc tin tiền vào tài khoản của chính bạn, tiền không đi vòng qua ai. Còn mô hình trung gian giữ tiền thì tiền chạy qua bên thứ ba rồi mới về, và bên đó cắt phần trăm mỗi đơn. Phần lớn shop Việt Nam bán bằng chuyển khoản chỉ cần cách thứ nhất.
Muốn hiểu sâu hơn về khái niệm, chuẩn kết nối và bức tranh open banking ở Việt Nam thì đọc bài API ngân hàng là gì và bản đồ open API ngân hàng Việt Nam 2026. Trang này đi thẳng vào phần dùng được: nối ngân hàng nào, chạy ra sao, giá bao nhiêu.
Việc nó làm được
Có API ngân hàng rồi thì tự động hoá được những gì
Đây là bốn việc khách của tụi em làm nhiều nhất, xếp theo thứ tự tiết kiệm công nhất.
Tự xác nhận đơn hàng
Khách quét mã QR chuyển tiền, nội dung chuyển khoản mang mã đơn. Phần mềm nhận tin báo có, khớp mã đơn, tự đổi trạng thái sang đã thanh toán. Ban đêm hay cuối tuần vẫn chạy, không phụ thuộc có ai trực hay không.
Mở khoá tài khoản, gia hạn gói
Phần mềm bán theo gói tháng thì sau khi tiền vào là mở khoá ngay, khách không phải chờ duyệt tay. Hết hạn mà có tiền vào thì gia hạn tiếp.
Đối soát cuối ngày
Mọi giao dịch được ghi lại kèm mã giao dịch của ngân hàng, nên cuối ngày đối chiếu sổ sách bằng dữ liệu chứ không bằng trí nhớ. Sai lệch bao nhiêu, ở đơn nào, tra ra trong một phút.
Báo tiền vào cho đúng người
Tin báo có bắn vào nhóm Telegram hoặc Zalo của bộ phận liên quan, kèm số tiền và nội dung. Chủ shop ngồi đâu cũng biết tiền về, không cần mở app ngân hàng.
Điểm chung của bốn việc trên: chúng đều đang được làm bằng tay ở rất nhiều nơi, và làm tay thì vừa chậm vừa sai. Một người trực ban ngày vẫn bỏ sót đơn lúc đông khách, còn ban đêm thì đơn nằm đó chờ tới sáng. Tiền đã vào tài khoản rồi mà khách vẫn phải đợi, đó là chỗ mất khách oan nhất.
Ngân hàng
Ngân hàng nào đang chạy với MONA Pay
Mỗi ngân hàng có một trang riêng ghi rõ cách nối, loại tài khoản hỗ trợ và những lưu ý riêng của ngân hàng đó. Bảng trạng thái hiện có 29 ngân hàng: ACB chạy chính thức tài khoản ảo và báo tiền vào tức thì, các ngân hàng còn lại ghi rõ đang ở bước nào để bạn biết trước khi chọn.
ACB · BIDV · VietinBank · MBBank · OCB · MSB · KienLongBank · TPBank · VPBank · Sacombank · Vietcombank · Techcombank · Agribank · HDBank · ABBANK · Eximbank · VIB · ShinhanBank · LPBank · BacABank · SeABank · SHB · PublicBank · NCB · Woori · VietABank · VietBank · NamABank · PGBank
Tài khoản ảo đáng chú ý khi bạn bán nhiều đơn giá gần nhau. Mỗi đơn một số tài khoản riêng thì khỏi lo khách quên ghi nội dung chuyển khoản, vì chỉ cần nhìn tiền vào tài khoản nào là biết đơn nào. Ngân hàng nào chưa hỗ trợ tài khoản ảo thì vẫn chạy được theo cách khớp nội dung chuyển khoản.
Cách chạy
Nối vào phần mềm của bạn mất bao lâu
Ba bước, phần lâu nhất là chờ ngân hàng gửi mã xác thực.
Chưa thấy câu của bạn? Gọi đội MONA1900 636 648- Nối tài khoản ngân hàng. Đăng nhập dashboard, chọn ngân hàng, xác thực bằng mã OTP ngân hàng gửi về. Sau bước này hệ thống bắt đầu đọc được giao dịch tiền vào.
- Khai chỗ nhận tin. Phổ biến nhất là webhook: bạn cho một đường dẫn HTTPS trong phần mềm của mình, mỗi lần có tiền vào MONA Pay gửi một gói dữ liệu JSON tới đó. Không có lập trình viên thì chọn Telegram, Zalo hoặc email, khỏi cần code dòng nào.
- Thử bằng giao dịch giả. Có sẵn chế độ sandbox tạo giao dịch giả để bạn chạy thử toàn bộ luồng mà không phải chuyển tiền thật, cũng không tính vào hạn mức.
Nếu bạn để AI viết code, việc còn nhẹ hơn nữa: MONA Pay có sẵn tài liệu dạng máy đọc và một MCP để Claude Code, Codex hay Cursor tự tích hợp. Xem trang dành cho AI agent.
Webhook là gì, khác gì với việc phần mềm tự hỏi ngân hàng?
Hai cách ngược chiều nhau. Tự hỏi (polling) là phần mềm của bạn cứ vài giây lại hỏi "có gì mới không", tốn tài nguyên và vẫn trễ. Webhook là chiều ngược lại: có giao dịch mới thì hệ thống chủ động gọi vào phần mềm của bạn ngay lúc đó. Nhanh hơn và nhẹ hơn, nên webhook là cách được dùng chính.
Webhook gửi lỗi thì có mất giao dịch không?
Không. Nếu phần mềm của bạn đang lỗi hoặc không trả về đúng, hệ thống gửi lại theo nhiều nhịp tăng dần. Mỗi giao dịch có một mã riêng để bạn chống ghi trùng: nhận hai lần cùng một mã thì chỉ xử lý một lần.
Bảo mật
Làm sao biết tin báo có là thật
Đây là câu hỏi đúng phải hỏi, vì nếu ai cũng gọi được vào đường dẫn webhook của bạn thì họ tự tạo đơn ảo được.
Mỗi gói tin gửi đi được ký bằng một chuỗi bí mật chỉ bạn và hệ thống biết, theo chuẩn HMAC-SHA256. Phần mềm của bạn tính lại chữ ký đó từ nội dung nhận được rồi so sánh, khớp thì mới nhận. Kèm theo là dấu thời gian, lệch quá năm phút thì từ chối, nên kẻ bắt được gói tin cũ cũng không phát lại được.
Một lớp nữa nằm ở bản chất mô hình: tiền đi thẳng từ khách vào tài khoản ngân hàng của bạn. MONA Pay không giữ tiền, không có quyền chuyển tiền đi, nên rủi ro lớn nhất của mô hình trung gian giữ tiền không tồn tại ở đây.
Chi phí
Giá của API ngân hàng MONA Pay
Tính theo số giao dịch, không cắt phần trăm trên số tiền. Một đơn 50.000 đ hay 50.000.000 đ đều tính như nhau.
- Miễn phí 500 giao dịch mỗi tháng, đủ tính năng: tài khoản ảo, VietQR, webhook, Telegram, API.
- Dùng nhiều hơn thì có gói trả phí từ 99.000 đ mỗi tháng, trả theo năm chỉ tính 10 tháng.
- Không phí giữ tiền, không phí rút tiền, vì tiền không đi qua MONA Pay.
Chi tiết từng gói và cách đếm giao dịch nằm ở bảng giá. Hoá đơn VAT xuất theo tháng, trả bằng tiền Việt.
So sánh
So với cách nhận tiền qua trung gian quốc tế
Bảng này so cách thu tiền, không so tên công ty.
| Điều | Trung gian quốc tế (Stripe, PayPal…) | API ngân hàng MONA Pay |
|---|---|---|
| Đường đi của tiền | Khách trả cho trung gian, trung gian giữ rồi chuyển về sau | Khách chuyển thẳng vào tài khoản ngân hàng của bạn |
| Cách tính phí | Phần trăm trên từng giao dịch, cộng phí cố định | Theo gói tháng tính bằng số giao dịch |
| Thời điểm nhận tiền | Theo chu kỳ đối soát của trung gian | Ngay lúc khách chuyển, vì tiền vào thẳng tài khoản |
| Tiền tệ và hoá đơn | Ngoại tệ, hoá đơn nước ngoài | Tiền Việt, hoá đơn VAT có mã số thuế |
| Hỗ trợ | Qua email, lệch múi giờ | Tổng đài tiếng Việt 1900 636 648 |
Không phải cách nào cũng thay được cách nào. Bán cho khách nước ngoài trả bằng thẻ thì trung gian quốc tế vẫn là đường đúng, và MONA Pay có trang riêng nói về phần đó. Còn khách Việt Nam chuyển khoản nội địa thì đi thẳng qua API ngân hàng gọn hơn và rẻ hơn.
Câu hỏi thường gặp
Những thứ người ta hay hỏi trước khi làm
Còn thắc mắc nào chưa có ở đây thì gọi tổng đài 1900 636 648, hoặc xem trang hỏi đáp đầy đủ.
Chưa thấy câu của bạn? Gọi đội MONA1900 636 648API ngân hàng có phải là ngân hàng mở (open banking) không?
Ngân hàng mở là khái niệm lớn hơn: ngân hàng chia sẻ dữ liệu và dịch vụ cho bên thứ ba qua API, gồm cả đọc thông tin lẫn thực hiện lệnh. API ngân hàng dùng để nhận tiền như MONA Pay là một lát cắt trong đó, và là lát cắt được dùng nhiều nhất vì nó giải quyết đúng chuyện bán hàng hằng ngày.
Dùng API ngân hàng có phải đưa mật khẩu tài khoản không?
Không. Bạn nối tài khoản một lần bằng xác thực của chính ngân hàng, hệ thống giữ quyền đọc giao dịch chứ không giữ mật khẩu đăng nhập, và không có quyền chuyển tiền đi. Quyền đọc và quyền chi là hai thứ tách rời.
Không có lập trình viên thì dùng được không?
Được. Nếu chỉ cần biết tiền về để xử lý bằng tay thì bật kênh Telegram, Zalo hoặc email là xong, không cần code. Còn nếu website đang chạy WordPress, WooCommerce, Haravan, Sapo, KiotViet hay Shopify thì đã có sẵn phần cắm vào, xem trang của từng nền tảng trên menu.
Tiền có bị giữ lại ngày nào không?
Không có ngày nào bị giữ. Khách chuyển khoản là tiền vào thẳng tài khoản ngân hàng đứng tên bạn, MONA Pay chỉ đọc tin báo có. Cái bạn mua là dịch vụ đọc và báo, không phải dịch vụ giữ tiền hộ.
Một tài khoản ngân hàng nối được nhiều website không?
Được. Bạn khai nhiều webhook cho nhiều hệ thống khác nhau, mỗi hệ thống nhận cùng một luồng giao dịch rồi tự lọc theo nội dung chuyển khoản hoặc theo tài khoản ảo riêng của mình.
Nối rồi mà muốn ngừng thì sao?
Bạn gỡ liên kết tài khoản trong dashboard bất cứ lúc nào, hệ thống ngừng đọc giao dịch ngay. Vì tiền chưa từng đi qua MONA Pay nên không có khoản nào phải chờ hoàn.
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, miễn phí 500 giao dịch mỗi tháng. 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.