POST/api/v2/qr-image

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

Name: Tra Cứu Bank API Engine
Rating: 4.9 (1250 reviews)

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.

Endpoint

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

Mẫu code tham khảo

bash

curl --location 'https://api.tracuubank.net/api/v2/qr-image' \
  --header 'x-api-key: <api_key>' \
  --header 'x-api-secret: <api_secret>' \
  --form 'file=@/path/to/your/file.png'

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 (multipart/form-data) (Bắt buộc)

Chỉ hỗ trợ file tải lên, không hỗ trợ base64.

Payload	Required	Data type	Description
file	Bắt buộc	file (png/jpg/jpeg/webp)	File ảnh: tối đa 2MB. Phải là mã QR được tạo từ VietQR.

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 / Hoặc lỗi đọc mã QR từ ảnh
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"
}