Một API cho số dư, giao dịch và xác nhận thanh toán.One API for balances, transactions and payment confirmation.
Kết nối MB Bank, ACB và TPBank. Tạo hóa đơn QR, đối soát giao dịch và xác nhận thanh toán qua một giao diện REST thống nhất.Connect MB Bank, ACB and TPBank. Create QR bills, reconcile transactions and confirm payments through one consistent REST surface.
Thông tin đăng nhập chỉ dùng cho request hiện tại.Credentials are used for the current request only.
01
Ba ngân hàng, một hợp đồng APIThree banks, one API contract
MB Bank, ACB và TPBank trả về cùng cấu trúc giao dịch để phần còn lại của hệ thống không phải rẽ nhánh theo ngân hàng.MB Bank, ACB and TPBank return the same transaction shape so the rest of the system does not branch per bank.
02
Đối soát theo PAY tokenReconcile by PAY token
Khớp số tiền, nội dung chuyển khoản và cửa sổ thời gian. Giao dịch khớp sẽ chuyển hóa đơn sang trạng thái paid.Match amount, transfer description and a time window. A matched transaction moves the bill to paid.
03
Từ hóa đơn đến QRFrom bill to QR
Tạo hóa đơn, nhận mã QR VietQR và kiểm tra trạng thái thanh toán qua cùng một endpoint.Create a bill, receive a VietQR code and check payment status from the same endpoint.
Tài liệu APIAPI reference
Tất cả endpoint là GET và trả JSON. Thông tin đăng nhập ngân hàng được truyền qua query string.Every endpoint is a GET that returns JSON. Bank credentials travel in the query string.
Lưu ý bảo mật.Security note.GET đưa thông tin đăng nhập vào URL và log. Chỉ dùng trong mạng nội bộ hoặc sau lớp proxy tin cậy.GET puts credentials in the URL and logs. Use this only on a trusted network or behind a trusted proxy.
GET
Tạo hóa đơnCreate a bill
/create
Tạo hóa đơn và trả về mã QR VietQR. bank nhận mbb hoặc acb.Create a bill and return a VietQR image. bank accepts mbb or acb.
Tham sốParameters
Tham số của GET /create
TênName
Bắt buộcRequired
Mô tảDescription
amount
CóYes
Số tiền thanh toán (VND).Payment amount in VND.
stk
CóYes
Số tài khoản nhận tiền.Receiving account number.
name
CóYes
Tên chủ tài khoản.Account holder name.
bank
KhôngNo
mbb hoặc acb. Mặc định acb.mbb or acb. Defaults to acb.
GET /create?amount=50000&stk=123456789&name=Nguyen%20Van%20A&bank=mbb
Đối soát giao dịch gần nhất với hóa đơn. Nếu khớp, hóa đơn chuyển sang paid.Reconcile recent transactions against a bill. On a match, the bill becomes paid.
Tham sốParameters
Tham số của GET /status
TênName
Bắt buộcRequired
Mô tảDescription
id
CóYes
ID hóa đơn.Bill identifier.
taikhoan
CóYes
Tài khoản đăng nhập ngân hàng.Bank login name.
matkhau
CóYes
Mật khẩu ngân hàng.Bank password.
bank
KhôngNo
acb, mbb hoặc tpbank. Mặc định acb.acb, mbb or tpbank. Defaults to acb.
accountNumber
KhôngNo
Số tài khoản cụ thể cho MB/TPBank.Specific account for MB/TPBank.
GET /status?id=hd_1234567890&taikhoan=0123456789&matkhau=password&bank=mbb&accountNumber=123456789
GET
Giao dịch MBMB transactions
/api/mb/transactions
Lấy lịch sử giao dịch MB Bank. Nếu bỏ accountNumber, API dùng tài khoản đầu tiên.Fetch MB Bank transaction history. If accountNumber is omitted, the first account is used.
Tham sốParameters
Tham số của GET /api/mb/transactions
TênName
Bắt buộcRequired
Mô tảDescription
username
CóYes
Tên đăng nhập MB Bank.MB Bank username.
password
CóYes
Mật khẩu MB Bank.MB Bank password.
accountNumber
KhôngNo
Số tài khoản. Mặc định là tài khoản đầu tiên.Account number. Defaults to the first account.
fromDate
KhôngNo
DD/MM/YYYY. Mặc định 7 ngày trước.DD/MM/YYYY. Defaults to 7 days ago.
toDate
KhôngNo
DD/MM/YYYY. Mặc định hôm nay.DD/MM/YYYY. Defaults to today.
GET /api/mb/transactions?username=0123456789&password=secret&fromDate=01/05/2026&toDate=15/05/2026
GET
Số dư MBMB balance
/api/balance
Trả về tổng số dư và danh sách tài khoản MB Bank.Return the total balance and all MB Bank accounts.
Tham sốParameters
Tham số của GET /api/balance
TênName
Bắt buộcRequired
Mô tảDescription
username
CóYes
Tên đăng nhập MB Bank.MB Bank username.
password
CóYes
Mật khẩu MB Bank.MB Bank password.
GET /api/balance?username=0123456789&password=secret
GET
Giao dịch ACBACB transactions
/api/acb/transactions
Lấy lịch sử giao dịch ACB trong khoảng 15 ngày trước và sau hiện tại.Fetch ACB transactions across a 15-day window around today.
Tham sốParameters
Tham số của GET /api/acb/transactions
TênName
Bắt buộcRequired
Mô tảDescription
username
CóYes
Tài khoản ACB.ACB account.
password
CóYes
Mật khẩu ACB.ACB password.
GET /api/acb/transactions?username=0123456789&password=secret
GET
Biến động ACBACB balance change
/api/acb/balance-change
Tổng tiền vào, tiền ra và chênh lệch trong dữ liệu ACB trả về.Total inflow, outflow and net change across the returned ACB data.
Tham sốParameters
Tham số của GET /api/acb/balance-change
TênName
Bắt buộcRequired
Mô tảDescription
username
CóYes
Tài khoản ACB.ACB account.
password
CóYes
Mật khẩu ACB.ACB password.
GET /api/acb/balance-change?username=0123456789&password=secret
GET
Giao dịch TPBankTPBank transactions
/api/tpbank/transactions
Lấy lịch sử giao dịch TPBank theo số tài khoản và khoảng ngày.Fetch TPBank transactions for an account and date range.
Tham sốParameters
Tham số của GET /api/tpbank/transactions
TênName
Bắt buộcRequired
Mô tảDescription
username
CóYes
Tên đăng nhập TPBank.TPBank username.
password
CóYes
Mật khẩu TPBank.TPBank password.
accountNumber
CóYes
Số tài khoản TPBank.TPBank account number.
fromDate
KhôngNo
YYYYMMDD.YYYYMMDD.
toDate
KhôngNo
YYYYMMDD.YYYYMMDD.
GET /api/tpbank/transactions?username=0123456789&password=secret&accountNumber=123456789
GET
Danh sách hóa đơnList bills
/bills
Trả về toàn bộ hóa đơn và thống kê theo trạng thái, ngân hàng.Return every bill plus counts by status and bank.
Gửi request thật tới server hiện tại. Kết quả trả về dưới dạng JSON, kèm mã QR nếu có.Send real requests to this server. Results appear as JSON, with a QR image when available.
Không lưu thông tin.Nothing is stored.Thông tin đăng nhập chỉ được dùng cho request hiện tại và không được ghi vào hóa đơn.Credentials are used for the current request only and are never written to a bill.
Trường có dấu * là bắt buộc.Fields marked * are required.
—
Chưa có kết quảNo result yetChọn endpoint, nhập thông tin và gửi request.Pick an endpoint, fill the form and send a request.