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": { ... } } |