Đến nội dung
BankGateway
Console ↗
Tìm kiếm tài liệu & API
Bắt đầu
Tổng quan dịch vụ

Cổng API Tra cứu số tài khoản Napas 24/7 theo chuẩn OpenBanking quốc tế. Độ trễ cực thấp O(1) Cache, xác thực Zero-Trust và chữ ký số Ed25519.

Bắt đầu
Bắt đầu nhanh (Quickstart)

Hướng dẫn thực hiện cuộc gọi API tra cứu số tài khoản đầu tiên trong vòng 3 phút bằng cURL, Node.js hoặc Python.

Xác thực & Bảo mật
Xác thực API Key

Cơ chế bảo mật Server-to-Server bằng Header X-API-Key, nguyên tắc giữ bí mật và quy trình thu hồi / cấp phát lại khóa.

Xác thực & Bảo mật
Chữ ký số Ed25519

Đảm bảo tính toàn vẹn và chống giả mạo dữ liệu ngân hàng bằng chữ ký mật mã Ed25519 đính kèm trong mỗi phản hồi.

Xác thực & Bảo mật
Chống trùng lặp (Idempotency)

Sử dụng Header Idempotency-Key chuẩn RFC 8470 để đảm bảo không bị trừ tiền hai lần khi mạng chập chờn hoặc retry.

API Tra cứu ngân hàngPOST
Tra cứu tài khoản

Đặc tả kỹ thuật Endpoint POST /api/v1/lookup. Tra cứu thời gian thực tên chủ tài khoản ngân hàng.

API Tra cứu ngân hàngPOST
Tra cứu theo lô & Webhook

Gửi danh sách hàng nghìn STK trong một request, nhận thông báo kết quả bất đồng bộ qua Webhook kèm chữ ký số.

API Tra cứu ngân hàngGET
Danh sách 68 ngân hàng

Danh mục mã ngân hàng (bankCode), mã BIN Napas, tên đầy đủ và tình trạng kết nối thời gian thực.

↑ ↓ Điều hướng↵ ChọnEsc Đóng
Mục lục tài liệu:Lấy lịch sử giao dịch MBBank ▾
Tài liệu/API Lịch sử giao dịch

Lấy lịch sử giao dịch MBBank

Truy vấn lịch sử giao dịch (LSGD) và biến động số dư tài khoản MBBank / Techcombank đã liên kết, dùng để tự động gạch nợ đơn hàng.

GET/api/v1/gateway/mbbank/historyAuthorization: Bearer <token>

Xác thực

API dùng Token riêng của từng tài khoản ngân hàng đã liên kết (lấy trong Dashboard › Cổng thanh toán), không dùng X-API-Key.

HeaderBắt buộcMô tả
AuthorizationBắt buộc*Bearer YOUR_NODE_TOKEN
X-TokenThay thếCó thể dùng thay cho Authorization.
X-Request-IdTuỳ chọnMã truy vết; nếu bỏ trống hệ thống tự sinh và trả về trong header phản hồi.

Tham số

QueryBắt buộcMô tả
accountNumberBắt buộcSố tài khoản đã liên kết trên hệ thống.
limitTuỳ chọnSố giao dịch trả về, 1–500. Mặc định 50.
syncTuỳ chọntrue để kích hoạt đồng bộ ngầm với ngân hàng (tối đa 1 lần / 10 giây / tài khoản).
cURL
curl -X GET 'https://api.bankgateway.org/api/v1/gateway/mbbank/history?accountNumber=0783825888&limit=50' \
  -H 'Authorization: Bearer YOUR_NODE_TOKEN'

Phản hồi

200 OK
{
  "status": "success",
  "requestId": "obg_3f9a1c2b7d4e",
  "message": "Thành công",
  "transactions": [
    {
      "transactionID": "FT26325123456789",
      "amount": 150000,
      "currency": "VND",
      "balanceAfter": 2350000,
      "description": "DH10293 thanh toan don hang",
      "transactionDate": "21/11/2026",
      "bookingDateTime": "2026-11-21T09:15:42+07:00",
      "type": "IN",
      "creditDebitIndicator": "CRDT",
      "bankCode": "MB",
      "counterPartyAccount": "0123456789",
      "counterPartyName": "NGUYEN VAN A"
    }
  ]
}
TrườngKiểuMô tả
transactionIDstringMã tham chiếu giao dịch phía ngân hàng.
amountnumberSố tiền (VND).
balanceAfternumberSố dư sau giao dịch.
descriptionstringNội dung chuyển khoản — dùng để khớp mã đơn.
transactionDatestringNgày giao dịch, định dạng dd/MM/yyyy.
bookingDateTimestringThời điểm ghi sổ ISO 8601 (+07:00).
typeIN | OUTChiều giao dịch.
creditDebitIndicatorCRDT | DBITGhi có / ghi nợ.
bankCodestringMB hoặc TCB.
counterPartyAccountstring | nullTài khoản đối ứng (nếu ngân hàng cung cấp).
counterPartyNamestring | nullTên đối ứng (nếu ngân hàng cung cấp).

Mã lỗi & giới hạn

HTTPMãÝ nghĩa
400—Thiếu số tài khoản hoặc token.
401—Số tài khoản hoặc token không đúng.
429RATE_LIMIT_EXCEEDEDQuá 30 request / phút / IP. Xem header Retry-After.
429TOKEN_BRUTEFORCE_LOCKEDSai token quá 10 lần trong 15 phút — IP bị khóa 15 phút.

Đường dẫn tương thích

EndpointGhi chú
GET /api/v1/gateway/mbbank/historyKhuyến nghị cho MBBank.
GET /api/v1/gateway/historyDùng chung cho mọi ngân hàng đã liên kết.
GET /api/v1/gateway/mbbank/history/:accountNumber/:tokenCũ — token trên path.
GET /api/v1/historyapimbv3/:password/:accountNumber/:tokenTương thích hệ thống tích hợp cũ.
Tài liệu phát hành theo chuẩn OpenBanking 2.0 · Cập nhật v1.0.5 (Chính thức)Góp ý tài liệu & Báo lỗi ↗