Kiến trúc kết nối tinh giản & mạnh mẽ
BankGateway cung cấp giao thức RESTful API đồng nhất trên nền HTTPS, cho phép ứng dụng của bạn tra cứu tên chủ tài khoản thụ hưởng tại 68 Ngân hàng / Công ty tài chính chỉ bằng 1 HTTP POST duy nhất.
https://api.bankgateway.pro| Tiêu chuẩn | Chi tiết triển khai |
|---|---|
| Giao thức | HTTPS TLS 1.3 · RESTful JSON · HTTP/2 |
| Xác thực | Header X-API-Key + Zero-Trust IP Whitelisting |
| Chữ ký số | Ed25519 Cryptographic Signature trong payload |
| Chống trùng lặp | Chuẩn Idempotency RFC 8470 với Idempotency-Key |
| Tốc độ phản hồi | 0ms - 2ms (Redis L1 / SQLite L2) | 45ms - 150ms (Upstream MB/Napas) |
| Định dạng STK | String giữ nguyên số 0 ở đầu (ví dụ: "0783825888") |
Quy trình tích hợp 4 bước
- 011. Khởi tạo tác vụ
Ứng dụng tạo mã Idempotency-Key (UUID v4) và chuẩn bị mã ngân hàng (bankCode) cùng số tài khoản (accountNumber).
- 022. Gửi lệnh từ Backend
Backend gọi POST /api/v1/lookup kèm header X-API-Key. Gateway kiểm tra hạn mức và định tuyến qua bộ đệm Two-Tier Cache.
- 033. Nhận phản hồi JSON sạch
Nhận kết quả tên chủ tài khoản, mã xác thực Ed25519, chi phí quyết toán và số dư khả dụng cập nhật tức thì.
- 044. Kiểm tra chữ ký & Hoàn tất
Lưu trữ requestId và đối soát số dư với sổ cái (Ledger) minh bạch.
Danh mục API cốt lõi
| Chức năng | Phương thức / Endpoint | Mục đích |
|---|---|---|
| Tra cứu tài khoản Napas | POST /api/v1/lookup | Tra cứu tên chủ tài khoản ngân hàng đơn lẻ (Real-time 0ms-80ms) |
| Kiểm tra số dư & Quota | GET /api/v1/wallet/balance | Truy vấn số dư ví khả dụng, gói tháng và hạn mức API Key |
| Sao kê sổ cái (Ledger) | GET /api/v1/wallet/statement | Đối soát lịch sử biến động số dư và các khoản khấu trừ minh bạch |
| Giải mã VietQR EMVCo | POST /api/v1/vietqr/decode | Giải mã chuỗi QR Code chuẩn Napas ra ngân hàng và STK |
| Danh mục ngân hàng | GET /api/v1/banks | Danh sách 68 Ngân hàng / Công ty tài chính, mã BIN Napas và logo nhận diện |