Tháng 10/2026 - Casso ra mắt sản phẩm hoá đơn điện tử miễn phí Xinvoice, Xem chi tiết
Trong trang nàyDịch vụ đã dừngDemoĐặc tả API

💼 API tra cứu Số Tài Khoản

Dịch vụ đã dừng

Demo

Truy cập https://demo.vietqr.io/ để xem demo

Đặc tả API

POSThttps://api.vietqr.io/v2/lookup

Tra cứu số tài khoản

API dùng để kiểm tra một số tài khoản ngân hàng có hợp lệ hay không. Nếu Số tài khoản này là hợp lệ, API sẽ trả về Tên Tài Khoản.

Tham số

TrườngMô tả
x-client-id bắt buộc
header
Client Id để chứng thực. Truy cập https://my.vietqr.io để lấy Client Id
x-api-key bắt buộc
header
API key để chứng thực. Truy cập https://my.vietqr.io để lấy API Key

Body

TrườngMô tả
bin bắt buộc
integer
Mã BIN ngân hàng
Ví dụ: 970415
accountNumber bắt buộc
string
Số tài khoản ngân hàng thụ hưởng. Chỉ nhập số, tối thiểu 6 ký tự, tối đa 19 kí tự
Ví dụ: 113366668888

Response 200

Số tài khoản hợp lệ

Success — Success - Thành công

{
  "code": "00",
  "desc": "Success - Thành công",
  "data": {
    "accountName": "QUY VAC XIN PHONG COVID 19"
  }
}

Account number invalid — Account number Invalid - Số tài khoản không hợp lệ

{
  "code": "42",
  "desc": "Account number Invalid - Số tài khoản không hợp lệ"
}

Bank not support — Bank not support - Ngân hàng không hỗ trợ

{
  "code": "41",
  "desc": "Bank not support - Ngân hàng không hỗ trợ"
}

Somthing went wrong — Oops, Something went wrong - Lỗi không xác định

{
  "code": "43",
  "desc": "Oops, Something went wrong - Lỗi không xác định"
}

All provider busy — All provider busy - Tất cả các API Provider đều đang bận.

{
  "code": "45",
  "desc": "All provider busy - Tất cả các API Provider đều đang bận."
}

Missing param — Missing param BIN/accountNumber

{
  "code": "10",
  "desc": "Missing param"
}

Invalid BIN — Invalid acqId - Mã định danh ngân hàng (thường gọi là BIN) 6 chữ số, quy đinh bởi ngân hàng nước. Xem BIN tại https://api.vietqr.io/v2/banks

{
  "code": "22",
  "desc": "Invalid acqId - Mã định danh ngân hàng (thường gọi là BIN) 6 chữ số, quy đinh bởi ngân hàng nước. Xem BIN tại https://api.vietqr.io/v2/banks"
}

Invalid account number — Invalid accountNo - số tài khoản thụ hưởng nhập số hoặc chữ(alias, nickname), tối thiểu 4 ký tự, tối đa 25 kí tự

{
  "code": "21",
  "desc": "Invalid accountNo - số tài khoản thụ hưởng nhập số hoặc chữ(alias, nickname), tối thiểu 4 ký tự, tối đa 25 kí tự"
}

Response 429

Too Many Request - Gọi API vượt quá Limit Rate