POSTGET/api/v2/qr-content

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

Chính sách cước & Điều kiện sử dụng

Cước phí: Tự động áp dụng theo biểu phí tra cứu hệ thống cấu hình (hoặc miễn phí theo chính sách quản trị viên).
Chống Spam: Tài khoản cần duy trì số dư tối thiểu từ 20.000đ để được cấp quyền gọi API tra cứu QR.

Lựa chọn: Trong trường hợp bạn cần tra cứu trực tiếp từ tệp ảnh QR, hãy xem Tra cứu qua ảnh QR ngay.

Endpoint

POSThttps://api.tracuubank.net/api/v2/qr-content

Mẫu cURL tham khảo

bash

curl --location 'https://api.tracuubank.net/api/v2/qr-content' \
  --header 'x-api-key: <api_key>' \
  --header 'x-api-secret: <api_secret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "content": "00020101021138590010A0000007270129......"
  }'

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 đã quét được — mã QR phải từ VietQR chuẩn EMVCo.

Trong đó:

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

Example Payload (JSON)

json

{
  "content": "00020101021138590010A0000007270129......"
}

Danh sách mã phản hồi (HTTP Status)

HTTP Code	Content-type	Response Message
200	json	Success (Tra cứu thông tin tài khoản thành công)
422	json	Not found (Nội dung mã QR không hợp lệ hoặc không tìm thấy TK)
429	json	Too many requests (Vượt quá giới hạn tốc độ)
402	json	Payment Required \| Out of Credit (Số dư không đủ)

200: Success response

json

{
  "code": 200,
  "success": true,
  "data": {
    "bank": "VCB",
    "ownerName": "PHAM ANH TUAN",
    "account": "9999999999"
  },
  "msg": "Success"
}