💼 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
https://api.vietqr.io/v2/lookupTra 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ường | Mô tả |
|---|---|
x-client-id bắt buộcheader | Client Id để chứng thực. Truy cập https://my.vietqr.io để lấy Client Id |
x-api-key bắt buộcheader | API key để chứng thực. Truy cập https://my.vietqr.io để lấy API Key |
Body
| Trường | Mô tả |
|---|---|
bin bắt buộcinteger | Mã BIN ngân hàng Ví dụ: 970415 |
accountNumber bắt buộcstring | 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
