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

Lấy thông tin chi tiết một tài khoản ngân hàng theo UUID qua SePay API v2. Trả về số tài khoản, ngân hàng, trạng thái và thông tin cấu hình.

||

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

GET
https://userapi.sepay.vn/v2/bank-accounts/{xid}

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

Tham số

xidstringrequired

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

Code mẫu

>
>
>
curl --request GET \
--url https://userapi.sepay.vn/v2/bank-accounts/f9e8d7c6-b5a4-3210-fedc-ba0987654321 \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response

Response 200
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"status": "success",
"data": {
"id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
"account_holder_name": "CONG TY TNHH PHAT DAT",
"account_number": "68720198345",
"accumulated": 8750000,
"last_transaction": "2026-02-27 08:15:00",
"label": "Tai khoan chinh",
"account_type": "personal",
"active": 1,
"created_at": "2025-01-15 10:30:00",
"bank_short_name": "ACB",
"bank_full_name": "Ngan hang TMCP A Chau",
"bank_bin": "970416",
"bank_code": "ACB"
}
}
Response 200 - Chi tiết tài khoản ngân hàng
{
  "status": "success",
  "data": {
    "id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
    "account_holder_name": "NGUYEN VAN A",
    "account_number": "68501234789",
    "accumulated": 15000000,
    "last_transaction": "2026-01-05 10:20:00",
    "label": "TK giao dich chinh",
    "account_type": "personal",
    "active": 1,
    "created_at": "2025-01-15 10:30:00",
    "bank_short_name": "ACB",
    "bank_full_name": "Ngan hang TMCP A Chau",
    "bank_bin": "970416",
    "bank_code": "ACB"
  }
}

Lỗi

  • 404: Trả 404 nếu tài khoản không tìm thấy hoặc không thuộc công ty đã xác thực