Tra cứu số tài khoản — qua nội dung QR (VietQR)

Hướng dẫn sử dụng API tra cứu thông tin ngân hàng thông qua nội dung QR của VietQR.

Lựa chọn

Trong trường hợp bạn cần kiểm tra qua ảnh QR, hãy dùng Tra cứu qua ảnh QR ngay.

Endpoint

POSThttps://api.banklookup.net/qr-content

Mẫu cURL tham khảo

curl --location 'https://api.banklookup.net/qr-content' \
--header 'x-api-key: <api_key>' \
--header 'x-api-secret: <api_secret>' \
--header 'Content-Type: application/json' \
--data '{
    "content": "00020101021138590010A0000007270129......"
}'Ngôn ngữ:curl

Header (Bắt buộc)

Các giá trị bắt buộc ở Header khi thực hiện Request.

Header	Required	Data type	Description
x-api-key	Bắt buộc	string	Mã API
x-api-secret	Bắt buộc	string	Mã Secret API

Body (JSON) (Bắt buộc)

Các giá trị bắt buộc ở Body khi thực hiện Request.

Payload	Required	Data type	Description
content	Bắt buộc	string	Nội dung mã VietQR

Trong đó:

content: Nội dung QR đã quét được — mã QR phải từ VietQR.

Example Payload (JSON)

{
    "content": "00020101021138590010A0000007270129......"
}Ngôn ngữ:json

Responses

HTTP code	Content-type	Response
`200`	`json`	Success
`422`	`json`	Not found
`429`	`json`	Too many requests
`402`	`json`	Payment Required \| Out of Credit

200: Success response

{
    "code": 200,
    "success": true,
    "data": {
      "bank": "<Mã ngân hàng>",
      "ownerName": "<Tên tài khoản>",
      "account": "<Số tài khoản>",
    },
    "msg": "Success"
  }Ngôn ngữ:json