Chi tiết tài khoản ảo

Lấy thông tin chi tiết một tài khoản ảo (VA) theo UUID qua SePay API v2.

Chi tiết tài khoản ảo

GET

https://userapi.sepay.vn/v2/bank-accounts/{ba_xid}/va/{va_xid}

Lấy thông tin chi tiết một tài khoản ảo theo UUID.

Tham số

ba_xidstringrequired

UUID tài khoản ngân hàng

va_xidstringrequired

UUID tài khoản ảo

Code mẫu

curl --request GET \
  --url https://userapi.sepay.vn/v2/bank-accounts/f9e8d7c6-b5a4-3210-fedc-ba0987654321/va/c3d4e5f6-a7b8-9012-cdef-123456789013 \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response

Response 200

{
  "status": "success",
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "va": "VA001234",
    "sub_holder_name": "NGUYEN VAN A",
    "label": "VA thanh toan",
    "active": 1,
    "official": 1,
    "static": 0,
    "bank_account_id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
    "created_at": "2025-06-01 09:00:00",
    "updated_at": "2026-01-08 10:20:45"
  }
}

Response 200 - Chi tiết tài khoản ảo

{
  "status": "success",
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789013",
    "va": "VA001234",
    "sub_holder_name": "NGUYEN VAN A",
    "label": "Thu ho khach le",
    "active": 1,
    "official": 1,
    "static": 0,
    "bank_account_id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
    "created_at": "2025-06-15 10:00:00",
    "updated_at": "2026-01-05 10:20:00"
  }
}

Lỗi

404: Trả 404 nếu VA không thuộc tài khoản ngân hàng chỉ định hoặc không thuộc công ty đã xác thực