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

thông tin

API này đang trong giai đoạn thử nghiệm.

Vui lòng liên hệ với chúng tôi để được cấp quyền sử dụng

Demo

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

Đặc tả API

thông tin

API tra cứu hiện tại hỗ trợ tra cứu số tài khoản hợp lệ từ 46/55 ngân hàng / tổ chức tín dụng tại Việt Nam. Truy cập API danh sách ngân hàng để lấy danh sách các ngân hàng hỗ trợ tra cứu

• postTra cứu số tài khoản

Documentation Powered by Redocly

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.

Authorizations:

(x-client-idx-api-key)

Request Body schema: application/json

bin required	integer Mã BIN ngân hàng
accountNumber required	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ự

Responses

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

Request samples

• Payload

Content type

application/json

{

• "bin": 970415,
• "accountNumber": 113366668888

}

Response samples

• 200

Content type

application/json

Example

SuccessAccount number invalidBank not supportSomthing went wrongAll provider busyMissing paramInvalid BINInvalid account numberSuccess

Success - Thành công

{

• "code": "00",
• "desc": "Success - Thành công",
• "data": {

  • "accountName": "QUY VAC XIN PHONG COVID 19"

  }

}

Code mẫu

CURL

curl --location --request POST 'https://api.vietqr.io/v2/lookup' \
--header 'x-client-id: <CLIENT_ID_HERE>' \
--header 'x-api-key: <API_KEY_HERE>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bin": "970432",
    "accountNumber": "222777313"
}'

Javascript (Axios)

var axios = require('axios');
var data = JSON.stringify({
  "bin": "970432",
  "accountNumber": "222777313"
});

var config = {
  method: 'post',
  url: 'https://api.vietqr.io/v2/lookup',
  headers: { 
    'x-client-id': '<CLIENT_ID_HERE>', 
    'x-api-key': '<API_KEY_HERE>', 
    'Content-Type': 'application/json',
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

C#

var client = new RestClient("https://api.vietqr.io/v2/lookup");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("x-client-id", "<CLIENT_ID_HERE>");
request.AddHeader("x-api-key", "<API_KEY_HERE>");
request.AddHeader("Content-Type", "application/json");
var body = @"{" + "\n" +
@"    ""bin"": ""970432""," + "\n" +
@"    ""accountNumber"": ""222777313""" + "\n" +
@"}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content)