QR Payment Gateway · v1

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.

  • MB Bank · ACB · TPBankMB Bank · ACB · TPBank
  • VietQRVietQR
  • Đối soát tự độngAutomatic reconciliation
  • Không lưu thông tin đăng nhậpNo credential storage
GET /api/balance
# 200 OK · application/json
{
  "success": true,
  "data": {
    "totalBalance": "999999999",
    "currencyEquivalent": "VND",
    "balances": [
      {
        "number": "0123456789",
        "balance": "9999999999"
      }
    ]
  }
}
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.