Danh sách giao dịch

Truy vấn danh sách giao dịch của công ty đã xác thực qua SePay API v2. Hỗ trợ phân trang, bộ lọc, sắp xếp và lấy dữ liệu mới qua since_id.

Danh sách giao dịch

GET
https://userapi.sepay.vn/v2/transactions
Thông tin

Danh sách giao dịch của công ty đã xác thực. Mặc định 20 giao dịch mỗi trang, tối đa 100.

Tham số
qstring

Tìm theo reference_number, transaction_content, code

bank_account_idstring

Lọc theo UUID tài khoản ngân hàng

va_idstring

Lọc theo UUID tài khoản ảo

bank_brand_namestring

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

transaction_date_fromstring

Ngày bắt đầu (bao gồm)

transaction_date_tostring

Ngày kết thúc (bao gồm)

amount_in_mininteger

Số tiền vào tối thiểu

amount_in_maxinteger

Số tiền vào tối đa

amount_out_mininteger

Số tiền ra tối thiểu

amount_out_maxinteger

Số tiền ra tối đa

reference_numberstring

Lọc theo mã tham chiếu (khớp chính xác)

transaction_contentstring

Tìm theo nội dung giao dịch

transfer_typeenum

Loại giao dịch: in hoặc out

webhook_successenum

Trạng thái webhook: 0 hoặc 1

since_idstring

Lấy giao dịch mới từ lần gọi trước. Truyền UUID giao dịch cuối cùng

transaction_date_sortenum

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

amount_in_sortenum

Sắp xếp theo số tiền vào: asc hoặc desc

amount_out_sortenum

Sắp xếp theo số tiền ra: 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
fieldsstring

Chọn trường trả về (danh sách phân cách bằng dấu phẩy)

timestamp_formatstring

Truyền iso8601 để chuyển tất cả trường datetime sang ISO 8601 với múi giờ Asia/Ho_Chi_Minh. Ví dụ: 2026-03-18T09:00:00+07:00

Code mẫu
>
>
>
curl --request GET \
  --url 'https://userapi.sepay.vn/v2/transactions?q=SOME_STRING_VALUE&bank_account_id=f9e8d7c6-b5a4-3210-fedc-ba0987654321&va_id=a2b3c4d5-e6f7-8901-bcde-f12345678901&bank_brand_name=ACB&transaction_date_from=2026-01-01%2000%3A00%3A00&transaction_date_to=2026-03-31%2023%3A59%3A59&amount_in_min=500000&amount_in_max=10000000&amount_out_min=SOME_INTEGER_VALUE&amount_out_max=SOME_INTEGER_VALUE&reference_number=SOME_STRING_VALUE&transaction_content=SOME_STRING_VALUE&transfer_type=SOME_STRING_VALUE&webhook_success=SOME_INTEGER_VALUE&since_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890&transaction_date_sort=SOME_STRING_VALUE&amount_in_sort=SOME_STRING_VALUE&amount_out_sort=SOME_STRING_VALUE&page=SOME_INTEGER_VALUE&per_page=SOME_INTEGER_VALUE&fields=SOME_STRING_VALUE&timestamp_format=SOME_STRING_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
30
31
{
  "status": "success",
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "transaction_date": "2026-02-18 09:35:12",
      "account_number": "0123456789",
      "va": "VA001",
      "transfer_type": "in",
      "amount_in": 500000,
      "amount_out": 0,
      "accumulated": 1500000,
      "transaction_content": "Thanh toan don hang #123",
      "reference_number": "FT26069ABC",
      "code": null,
      "bank_brand_name": "ACB",
      "bank_account_id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
      "va_id": "a2b3c4d5-e6f7-8901-bcde-f12345678901",
      "webhook_success": 1
    }
  ],
  "meta": {
    "pagination": {
      "total": 150,
      "per_page": 20,
      "current_page": 1,
      "last_page": 8,
      "has_more": true
    }
  }
}
Response 200 - Danh sách giao dịch
{
  "status": "success",
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "transaction_date": "2025-08-15 09:30:00",
      "account_number": "19028745631",
      "va": "VA001",
      "amount_in": 500000,
      "amount_out": 0,
      "accumulated": 1500000,
      "transaction_content": "Chuyen tien mua hang DH2025001",
      "reference_number": "FT26069ABC",
      "code": "ABC123",
      "bank_brand_name": "ACB",
      "bank_account_id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
      "va_id": "a2b3c4d5-e6f7-8901-bcde-f12345678901",
      "webhook_success": 1,
      "transfer_type": "in"
    }
  ],
  "meta": {
    "pagination": {
      "total": 150,
      "per_page": 20,
      "current_page": 1,
      "last_page": 8,
      "has_more": true
    }
  }
}
Ghi chú
  • id là UUID của giao dịch
  • bank_account_id là UUID của tài khoản ngân hàng
  • va_id là UUID của VA, null nếu giao dịch không qua VA
  • webhook_success: 0 = chưa gửi/thất bại, 1 = thành công, null nếu không có cấu hình webhook
  • Trường tiền tệ luôn là integer
  • q tìm kiếm đồng thời trên reference_number, transaction_content, code
  • since_id lấy dữ liệu mới: trả các giao dịch có ID lớn hơn giá trị chỉ định, sắp xếp tăng dần
  • per_page tối đa 100
Ví dụ sử dụng

Lấy giao dịch tiền vào từ 500,000 đến 1,000,000

cURL
1
2
3
curl -X GET "https://userapi.sepay.vn/v2/transactions?amount_in_min=500000&amount_in_max=1000000" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Polling giao dịch mới với since_id

cURL
1
2
3
curl -X GET "https://userapi.sepay.vn/v2/transactions?since_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Tìm kiếm giao dịch theo nội dung

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