API Chi tiết tài khoản ngân hàng

API lấy thông tin chi tiết của một tài khoản ngân hàng cụ thể, bao gồm thông tin tài khoản chính và danh sách tài khoản ảo (Virtual Account) liên kết.

API Endpoint

GET

https://bankhub-api-sandbox.sepay.vn/v1/bank-account/{bank_account_id}

Path Parameters

bank_account_idstringrequired

ID của tài khoản ngân hàng

Lưu ý

API này yêu cầu Bearer Token trong header Authorization
Tài khoản phải thuộc về merchant đang xác thực
Response bao gồm cả danh sách tài khoản ảo (Virtual Account) nếu có

Xử lý lỗi

401Unauthorized

Access token không hợp lệ hoặc đã hết hạn

404Not Found

Tài khoản không tồn tại hoặc không thuộc merchant này

API Response

Response 200 - Thành công

{
  "data": {
    "xid": "string",
    "company_xid": "string",
    "brand_name": "string",
    "account_holder_name": "string",
    "account_number": "string",
    "accumulated": "string",
    "bank_api_connected": "string",
    "active": "string",
    "last_transaction": "string",
    "identification_number": "string",
    "phone_number": "string",
    "created_at": "string",
    "updated_at": "string",
    "va_list": [
      {
        "xid": "string",
        "sub_account": "string",
        "sub_holder_name": "string",
        "active": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ]
  }
}

dataobject

Thông tin chi tiết tài khoản

Code mẫu

curl --request GET \
  --url https://bankhub-api-sandbox.sepay.vn/v1/bank-account/780717f8-eeb6-11f0-b16e-52c7e9b4f41b \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Ví dụ sử dụng

JSLấy chi tiết tài khoản ngân hàng

curl --location 'https://bankhub-api-sandbox.sepay.vn/v1/bank-account/ba_abc123xyz' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Lưu ý quan trọng

Virtual Account (VA): Tài khoản ảo là các tài khoản con được tạo từ tài khoản ngân hàng chính, giúp phân biệt nguồn tiền từ các khách hàng khác nhau
Identification Number: Số CMND/CCCD phục vụ mục đích xác thực và tuân thủ quy định
Phone Number: Số điện thoại dùng để nhận thông báo và xác thực giao dịch
Empty VA List: Nếu va_list rỗng ([]), tài khoản chưa có tài khoản ảo nào được tạo