Biến động số dư tự động MB Bank là cơ chế lấy dữ liệu giao dịch từ tài khoản MB về hệ thống của bạn qua API: mỗi lần tiền vào hoặc tiền ra, ngân hàng gửi một bản ghi có cấu trúc gồm số tiền, thời gian, số dư sau giao dịch và nội dung chuyển khoản. Khác với thông báo đẩy trên ứng dụng MB vốn chỉ để người đọc, bản ghi API là dữ liệu máy đọc được, nên phần mềm mới đối soát đơn hàng, ghi bảng tính và kích hoạt xuất hóa đơn thay người được. Bài này giải thích bản ghi đó gồm những gì, dữ liệu về rồi đi đâu và cần điều kiện gì để bật.
Căn cứ hợp tác: MB xác nhận tiện ích dữ liệu nào?
Theo thông báo hợp tác giữa MB Bank và Pay2S, MB Bank – Chi nhánh Bắc Sài Gòn đã có thông báo ngày 31/10/2024 xác nhận hợp tác với Công ty Cổ phần FUTE về triển khai kết nối API. Hai tiện ích được nêu rõ trong thông báo: truy vấn tài khoản và gửi biến động số dư cho khách hàng của FUTE có tài khoản mở tại MB. Pay2S là nền tảng do FUTE phát triển, và tiền của người bán nằm tại ngân hàng chứ nền tảng không giữ tiền. Phạm vi của API cũng cần hiểu đúng: nó phục vụ việc lấy dữ liệu giao dịch về hệ thống của chính chủ tài khoản, không phải công cụ chuyển tiền hộ.
Một bản ghi biến động gồm những trường gì?
Mỗi giao dịch phát sinh trên tài khoản MB đã kết nối sẽ trở thành một bản ghi. Bốn trường dưới đây là phần quyết định việc đối soát có chạy tự động được hay không:
| Trường dữ liệu | Nội dung | Vì sao quan trọng cho đối soát |
|---|---|---|
| Số tiền | Giá trị ghi có hoặc ghi nợ của giao dịch | Điều kiện khớp đầu tiên với số tiền của đơn hàng |
| Thời gian giao dịch | Mốc thời gian ngân hàng ghi nhận giao dịch | Sắp xếp thứ tự, xác định giao dịch thuộc ca bán hàng nào |
| Số dư sau giao dịch | Số dư tài khoản ngay sau khi giao dịch hoàn tất | Kiểm chứng chuỗi giao dịch liên tục, phát hiện bản ghi bị thiếu |
| Nội dung chuyển khoản | Dòng nội dung khách ghi khi chuyển tiền | Nơi chứa mã đơn, căn cứ để gắn giao dịch vào đúng đơn hàng |
Trong bốn trường, nội dung chuyển khoản là trường mong manh nhất vì nó do khách gõ tay: chuyển đúng mã đơn thì hệ thống gắn giao dịch vào đơn ngay, chuyển không ghi hoặc ghi sai thì giao dịch vẫn được ghi nhận nhưng rơi vào nhóm chưa khớp, chờ người xử lý. Số tiền và thời gian thì do ngân hàng ghi, không phụ thuộc khách, nên là hai trường đáng tin nhất để lọc bước đầu. Số dư sau giao dịch ít ai để ý nhưng lại là công cụ kiểm tra tính đầy đủ: nếu chuỗi số dư bị đứt đoạn, nghĩa là có giao dịch chưa về hệ thống và cần kiểm tra lại kết nối.
Dữ liệu về rồi đi đâu?
Bản ghi biến động chỉ là điểm bắt đầu. Sau khi về hệ thống, cùng một dữ liệu có thể đi tiếp bốn hướng, tùy cách bạn cấu hình:
Hướng 1 – Hiển thị và đối soát ngay trong Pay2S. Giao dịch hiện trong danh sách, hệ thống tự so số tiền và nội dung với đơn hàng để đánh dấu đơn đã thanh toán. Đây là hướng dùng sẵn, không cần thêm công cụ.
Hướng 2 – Đưa về Google Sheet. Giao dịch được ghi thành từng dòng trên bảng tính để chủ shop và kế toán theo dõi, lọc và tổng hợp theo ngày. Cách làm chi tiết có trong template đối soát giao dịch trên Google Sheet.
Hướng 3 – Đẩy webhook về website hoặc phần mềm riêng. Mỗi biến động mới được gửi về địa chỉ nhận bạn cấu hình, để website tự xác nhận đơn, kích hoạt tài khoản cho khách hoặc ghi vào hệ thống nội bộ. Hướng này dành cho đơn vị có phần mềm riêng cần nhận sự kiện theo thời gian thực.
Hướng 4 – Làm đầu vào cho xuất hóa đơn tự động. Khi giao dịch đã khớp đơn, nó trở thành căn cứ để hệ thống phát hành hóa đơn điện tử qua nhà cung cấp tích hợp sẵn (Mắt Bão, Viettel, Bkav, MISA, FPT, M-Invoice). Toàn bộ chuỗi từ tiền về đến hóa đơn được giải thích trong bài hóa đơn tự động là gì. Trên Pay2S, tính năng xuất hóa đơn tự động có từ gói Basic 150.000 đồng/tháng trở lên và nền tảng không thu phí theo giao dịch.
Bốn hướng này không loại trừ nhau: shop nhỏ thường chỉ cần hướng 1 và 2, đơn vị có website riêng bật thêm hướng 3. Điểm cần nhớ là mọi hướng đều dùng chung một nguồn bản ghi, nên khâu kết nối ban đầu phải đúng.
Điều kiện tài khoản và các bước kết nối tóm tắt
Điều kiện cơ bản: bạn cần có tài khoản MB Bank thuộc diện được kết nối theo chương trình hợp tác, và tài khoản Pay2S để nhận dữ liệu. MB Bank nằm trong nhóm 5 ngân hàng có công văn hợp tác công khai với Pay2S (Vietcombank, MB Bank, ACB, BIDV, OCB), trong 8 ngân hàng hãng công bố đồng bộ được giao dịch.
Hai hướng kết nối cần phân biệt rõ:
OpenAPI là hướng kết nối chính thức theo hồ sơ tích hợp với ngân hàng. Đây là hướng nên ưu tiên khi tài khoản của bạn thuộc diện áp dụng, vì dữ liệu đi qua kênh được ngân hàng xác nhận.
RPA qua Internet Banking là hướng dùng thông tin đăng nhập Internet Banking để hệ thống truy vấn thay người, có thể phát sinh bước nhập OTP. Cần nói thẳng: đây không phải OpenAPI chính thức của ngân hàng. Pay2S có cơ chế Hosted Link để thông tin đăng nhập không phải đưa qua giao diện của đối tác trung gian, giảm rủi ro khi phải dùng hướng này.
Các bước tóm tắt: chuẩn bị tài khoản MB và hồ sơ theo đúng loại hình (cá nhân, hộ kinh doanh hay doanh nghiệp có mẫu kết nối khác nhau); thực hiện kết nối trong Pay2S theo hướng dẫn của từng hướng kết nối; kiểm tra giao dịch thử bằng một khoản chuyển nhỏ; cuối cùng mới cấu hình nơi dữ liệu đi tiếp như Sheet, webhook hay hóa đơn. Đừng bỏ qua bước chuyển thử, vì đó là cách duy nhất chắc chắn bản ghi đã về đủ bốn trường.
Hiểu nhầm thường gặp
Hiểu nhầm lớn nhất là nghĩ rằng điện thoại đã nhận thông báo tiền về trên ứng dụng MB thì coi như đã tự động hóa. Thông báo đó chỉ là dòng chữ cho người đọc: không có trường dữ liệu tách bạch, không gắn được vào đơn hàng, không ghi xuống bảng tính và không kích hoạt được phần mềm nào. Muốn máy làm thay, dữ liệu phải đi qua kết nối API có cấu trúc như đã nói ở trên.
Câu hỏi thường gặp
Tôi đang dùng tài khoản MB cá nhân thì kết nối được không?
Pay2S có mẫu kết nối riêng cho tài khoản cá nhân, hộ kinh doanh và doanh nghiệp. Tài khoản của bạn đi theo hướng OpenAPI hay RPA phụ thuộc vào diện áp dụng của từng chương trình tích hợp. Khi đăng ký, đại lý sẽ kiểm tra và tư vấn đúng hướng cho loại tài khoản của bạn.
Dữ liệu biến động MB có đưa về Google Sheet được không?
Được. Sau khi kết nối, giao dịch MB được đồng bộ về hệ thống và ghi thành từng dòng trên Google Sheet để đối soát và theo dõi dòng tiền. Bạn có thể bắt đầu từ template đối soát có sẵn rồi tùy chỉnh cột theo nhu cầu.
Kết nối API MB có làm lộ thông tin đăng nhập ngân hàng không?
Với hướng OpenAPI chính thức, kết nối thực hiện theo hồ sơ tích hợp và không dựa trên việc chia sẻ mật khẩu Internet Banking. Với hướng RPA, thông tin đăng nhập được nhập qua Hosted Link của hệ thống thay vì đưa qua giao diện đối tác. Dù theo hướng nào, chỉ thực hiện kết nối trong giao diện chính thức của Pay2S, không gửi thông tin đăng nhập qua tin nhắn.
Bắt đầu kết nối MB Bank với Pay2S
Nếu bạn đang nhận tiền qua MB Bank và muốn biến động số dư tự chạy về hệ thống thay vì ngồi đọc thông báo, thứ tự làm đúng là: kiểm tra loại tài khoản, chọn hướng kết nối phù hợp, chuyển thử một khoản nhỏ để xác nhận dữ liệu, rồi mới bật các hướng dùng tiếp theo. Hóa Đơn Tự Động là đại lý tư vấn triển khai Pay2S, hỗ trợ cấu hình ban đầu khi bạn đăng ký qua liên kết đại lý hoặc gọi 0979990560. Website hoạt động với vai trò đại lý và có hoa hồng khi bạn đăng ký qua liên kết trên trang; giá gói và tính năng không đổi so với đăng ký trực tiếp với hãng.
