Trong trang này
Danh sách ngân hàng
Trả về danh sách các ngân hàng được QHTech hỗ trợ, kèm mã ngân hàng (code) và mã BIN. Dùng để đổ dữ liệu vào dropdown chọn ngân hàng, hoặc lấy code/bin phục vụ sinh mã VietQR.
GET /api/banks
- Xác thực: không cần — đây là endpoint công khai.
- Định dạng: JSON (mảng, không bọc trong
data).
#Ví dụ request
curl "https://app.qh2pay.com/api/banks" \
-H "Accept: application/json"
const res = await fetch("https://app.qh2pay.com/api/banks");
const banks = await res.json();
#Response 200 OK
Trả về một mảng JSON các ngân hàng:
[
{
"id": 1,
"code": "BIDV",
"bin": "970418",
"name": "Ngân hàng TMCP Đầu tư và Phát triển Việt Nam",
"created_at": "2025-01-01 00:00:00",
"updated_at": "2025-01-01 00:00:00"
},
{
"id": 2,
"code": "MB",
"bin": "970422",
"name": "Ngân hàng TMCP Quân đội",
"created_at": "2025-01-01 00:00:00",
"updated_at": "2025-01-01 00:00:00"
}
]
#Mô tả field
| Field | Kiểu | Mô tả |
|---|---|---|
id |
int | ID ngân hàng trong hệ thống QHTech |
code |
string | Mã ngân hàng viết tắt (ví dụ BIDV, MB). Dùng cho tham số bank_code khi sinh QR |
bin |
string | Mã định danh ngân hàng (BIN) theo chuẩn Napas/VietQR |
name |
string | Tên đầy đủ của ngân hàng |
Danh sách trả về đúng theo dữ liệu ngân hàng đang cấu hình trong hệ thống. Hãy dùng trực tiếp giá trị
codetừ response này khi gọi các API khác để tránh sai lệch.