API Docs - Tài liệu hướng dẫn tích hợp
POSTGET/api/v2/lookup

Tra cứu số tài khoản

Hướng dẫn sử dụng API tra cứu thông tin ngân hàng. Hỗ trợ phương thức POST (khuyến nghị gửi Body JSON) và GET (gửi Query parameters).

Mới!Giờ đây, bạn có thể dùng QR để truy xuất thông tin chủ thể, xem hướng dẫn cho ảnh QR ngay.

Endpoint

POSThttps://api.tracuubank.net/api/v2/lookup

Mẫu cURL tham khảo

bash
curl -X POST "https://api.tracuubank.net/api/v2/lookup" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-api-secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "bank": "VCB",
    "account": "1049850384"
  }'

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

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

PayloadRequiredData typeDescription
bankBắt buộcstringMã code ngân hàng (hoặc mã BIN). Xem danh sách hỗ trợ tại /document/bank-list.
accountBắt buộcstringSố tài khoản cần kiểm tra

Trong đó:

  • bank: Mã code của ngân hàng trong danh sách hỗ trợ, ví dụ: ACB, VCB, MB, VIB,...
  • account: Số tài khoản cần tìm (đảm bảo không chứa ký tự đặc biệt nào), ví dụ: 123456789

Example Payload (JSON)

json
{
    "bank": "<bank code>",
    "account": "<account number>"
}

Responses

HTTP codeContent-typeResponse
200jsonSuccess (Tra cứu thành công)
422jsonNot found / Invalid bank BIN
429jsonToo many requests (Vượt quá giới hạn lượt gọi API)
402jsonPayment Required | Out of Credit (Hết số dư tài khoản)

200: Success response

json
{
    "code": 200,
    "success": true,
    "data": {
        "ownerName": "NGUYEN VAN A",
        "bank": "MB",
        "account": "123456789"
    },
    "msg": "Success",
    "timestamp": 1791299267138
}

422: Error response (Not Found / Invalid BIN)

1. Tài khoản không tồn tại (NOT_FOUND):

json
{
    "code": 422,
    "success": false,
    "msg": "NOT_FOUND",
    "data": null
}

2. Mã ngân hàng không hợp lệ (INVALID_BANK_BIN):

json
{
    "code": 422,
    "success": false,
    "data": [],
    "msg": "INVALID_BANK_BIN",
    "timestamp": 1791297900177
}