Bank Lookup API
Tài liệu hướng dẫn tích hợp API tra cứu & xác thực thông tin tài khoản ngân hàng. Chọn một endpoint bên dưới để xem chi tiết thông số và mẫu code.
Danh sách Endpoint API
Tra cứu qua số tài khoản
/api/v2/lookupLấy tên chủ tài khoản từ số tài khoản và mã ngân hàng (Hỗ trợ cả POST Body JSON & GET Query).
Tra cứu qua ảnh QR
/api/v2/qr-imageUpload tệp ảnh QR VietQR (multipart/form-data) để tự động trích xuất thông tin chủ tài khoản.
Tra cứu qua nội dung QR
/api/v2/qr-contentTruyền chuỗi nội dung QR VietQR đã giải mã theo chuẩn EMVCo để lấy thông tin tài khoản.
Xác thực chủ tài khoản
/api/v2/owner-checkKiểm tra đối soát 3 thông số Số tài khoản, Tên chủ sở hữu và Ngân hàng có khớp chính xác không.
Danh sách ngân hàng hỗ trợ
/api/v2/banks/listTra cứu & lọc danh sách 60+ ngân hàng Việt Nam, logo SVG, mã BIN và trạng thái Napas 247.
Thông tin số dư khả dụng (My Credit)
/api/v2/my-creditKiểm tra số dư khả dụng còn lại của tài khoản API Key để cảnh báo nạp tiền / đối soát tự động.
Nạp tiền tự động & Kiểm tra hóa đơn
/api/v2/deposit/*Tạo yêu cầu nạp tiền kèm mã VietQR Base64 (POST) & kiểm tra đối soát trạng thái thanh toán (GET/POST).
Môi trường thử nghiệm Sandbox
Mới/api/v2/sandbox/lookupBản sao không tốn phí của nhóm tra cứu, có sẵn kịch bản mô phỏng mọi mã phản hồi (200, 422, 402, 500).
Base URL
Mọi request đều gửi tới địa chỉ gốc dưới đây.
https://api.tracuubank.netXác thực
Mọi endpoint đều yêu cầu hai header xác thực. Bạn có thể lấy khóa trong trang API Key của tài khoản.
| Header | Required | Data type | Description |
|---|---|---|---|
| x-api-key | Bắt buộc | string | Mã API Key định danh ứng dụng |
| x-api-secret | Bắt buộc | string | Mã Secret API dùng để ký và xác thực yêu cầu |
Lấy khóa tại Bảng điều khiển → API Key.
Mã lỗi chung
| HTTP code | Content-type | Response |
|---|---|---|
| 200 | json | Thành công |
| 400 | json | Bad Request — Dữ liệu đầu vào thiếu hoặc sai định dạng |
| 401 | json | Unauthorized — Sai hoặc thiếu x-api-key / x-api-secret |
| 402 | json | Payment Required — Hết số dư trong tài khoản |
| 422 | json | Unprocessable Entity — Không tìm thấy tài khoản / ngân hàng không hỗ trợ |
| 429 | json | Too Many Requests — Quá nhiều request (Rate limit vượt ngưỡng) |
| 500 | json | Internal Server Error — Lỗi kết nối Napas / máy chủ bảo trì |