Bỏ qua tới nội dung
Tài liệu Lấy API Token
Trong trang này

Tài khoản ngân hàng

Lấy danh sách tài khoản ngân hàng đã liên kết với QHTech của bạn. Dùng id trả về làm bank_account_id khi tạo VA, lọc danh sách VA hoặc lọc lịch sử giao dịch.

GET /api/bank-accounts
  • Xác thực: bắt buộc — Authorization: Bearer {token} (xem Xác thực).
  • Chỉ trả về tài khoản ngân hàng thuộc về chủ token.
  • Kết quả sắp xếp theo thời gian liên kết mới nhất trước và được phân trang.

#Tham số truy vấn

Tất cả đều tùy chọn.

Tham số Kiểu Mặc định Mô tả
q string — Tìm kiếm (LIKE) theo số tài khoản hoặc tên chủ tài khoản
per_page int (1–100) 20 Số bản ghi mỗi trang
page int 1 Trang hiện tại

#Ví dụ request

curl "https://qh2pay.com/api/bank-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
const res = await fetch("https://qh2pay.com/api/bank-accounts", {
    headers: {
        Authorization: `Bearer ${API_TOKEN}`,
        Accept: "application/json",
    },
});
const json = await res.json();

#Response 200 OK

{
    "data": [
        {
            "id": "ca0a96f9-7ac2-4470-be2f-89f854a27cef",
            "bank_code": "BIDV",
            "bank_name": "Ngân hàng TMCP Đầu tư và Phát triển Việt Nam",
            "account_no": "6377778888",
            "account_holder_name": "CONG TY TNHH QH TECH SOLUTIONS",
            "hint_name": "Tài khoản thu hộ",
            "va_prefix": "V3QHT",
            "virtual_accounts_count": 12,
            "status": 1,
            "created_at": "2026-09-14 21:20:00"
        }
    ],
    "links": { "first": "...", "last": "...", "prev": null, "next": null },
    "meta": { "current_page": 1, "last_page": 1, "per_page": 20, "total": 1 }
}

#Mô tả field

Field Kiểu Mô tả
id string (UUID) ID tài khoản ngân hàng — dùng làm bank_account_id ở các API khác
bank_code string Mã ngân hàng (xem danh sách ngân hàng)
bank_name string | null Tên đầy đủ của ngân hàng
account_no string Số tài khoản ngân hàng
account_holder_name string Tên chủ tài khoản
hint_name string | null Tên gợi nhớ bạn đặt trên dashboard
va_prefix string | null Tiền tố VA. null → tài khoản này chưa tạo được VA
virtual_accounts_count int Số VA đang có của tài khoản
status int 1 = hoạt động, 0 = tạm dừng
created_at string Thời điểm liên kết (Y-m-d H:i:s)

#Lỗi

Tình huống HTTP Body
Thiếu / sai token 401 { "message": "API Token không hợp lệ." }
Tham số sai định dạng 422 { "message": "...", "errors": { ... } }