Bỏ qua tới nội dung
QH2Pay Tài liệu Lấy API Token
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ị code từ response này khi gọi các API khác để tránh sai lệch.