API lấy danh sách tài khoản ngân hàng

Lấy danh sách tài khoản ngân hàng của công ty đã xác thực qua SePay API v2. Trả về thông tin tài khoản BIDV, Sacombank và các ngân hàng kết nối.

||

Danh sách tài khoản ngân hàng

GET
https://userapi.sepay.vn/v2/bank-accounts
Thông tin

Danh sách tài khoản ngân hàng của công ty đã xác thực. Mặc định 20 tài khoản mỗi trang, tối đa 100.

Tham số

bank_short_namestring

Lọc theo tên ngắn ngân hàng (ví dụ: ACB, BIDV, VPB)

last_transaction_fromstring

Giao dịch cuối từ ngày

last_transaction_tostring

Giao dịch cuối đến ngày

accumulated_mininteger

Số dư tích lũy tối thiểu

accumulated_maxinteger

Số dư tích lũy tối đa

qstring

Tìm theo tên, nhãn hoặc số tài khoản

activestring

Lọc theo trạng thái: 1 = hoạt động, 0 = ngưng

created_at_sortenum

Sắp xếp theo ngày tạo: asc hoặc desc

last_transaction_sortenum

Sắp xếp theo ngày giao dịch cuối: asc hoặc desc

accumulated_sortenum

Sắp xếp theo số dư: asc hoặc desc

pageinteger

Số trang

Mặc định: 1
per_pageinteger

Số bản ghi mỗi trang (tối đa 100)

Mặc định: 20

Code mẫu

>
>
>
curl --request GET \
  --url 'https://userapi.sepay.vn/v2/bank-accounts?bank_short_name=ACB&last_transaction_from=SOME_STRING_VALUE&last_transaction_to=SOME_STRING_VALUE&accumulated_min=SOME_INTEGER_VALUE&accumulated_max=SOME_INTEGER_VALUE&q=SOME_STRING_VALUE&active=SOME_STRING_VALUE&created_at_sort=SOME_STRING_VALUE&last_transaction_sort=SOME_STRING_VALUE&accumulated_sort=SOME_STRING_VALUE&page=SOME_INTEGER_VALUE&per_page=SOME_INTEGER_VALUE' \
  --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
19
20
21
22
23
24
25
26
27
28
29
{
  "status": "success",
  "data": [
    {
      "id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
      "account_holder_name": "CONG TY CP VINA TECH",
      "account_number": "19033256789",
      "accumulated": 23500000,
      "last_transaction": "2026-03-05 11:22:45",
      "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"
    }
  ],
  "meta": {
    "pagination": {
      "total": 5,
      "per_page": 20,
      "current_page": 1,
      "last_page": 1,
      "has_more": false
    }
  }
}
Response 200 - Danh sách tài khoản ngân hàng
{
  "status": "success",
  "data": [
    {
      "id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
      "account_holder_name": "CONG TY CP TECH VINA",
      "account_number": "19028745631",
      "accumulated": 15000000,
      "last_transaction": "2025-08-15 09:30: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"
    }
  ],
  "meta": {
    "pagination": {
      "total": 5,
      "per_page": 20,
      "current_page": 1,
      "last_page": 1,
      "has_more": false
    }
  }
}

Ghi chú

  • id là UUID của tài khoản ngân hàng
  • accumulated là integer (VND)
  • q tìm kiếm đồng thời trên label, account_holder_name và account_number

Ví dụ sử dụng

Lấy tài khoản ngân hàng của BIDV

cURL
1
2
3
curl -X GET "https://userapi.sepay.vn/v2/bank-accounts?bank_short_name=BIDV" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Lọc tài khoản có số dư tích lũy từ 1,000,000 trở lên

cURL
1
2
3
curl -X GET "https://userapi.sepay.vn/v2/bank-accounts?accumulated_min=1000000" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Tìm kiếm tài khoản theo tên chủ tài khoản

cURL
1
2
3
curl -X GET "https://userapi.sepay.vn/v2/bank-accounts?q=CONG+TY+ABC" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Trước
—
Tiếp theo
—