API Giao dịch

Giao dịch là các giao dịch ngân hàng đã phát sinh. Bạn có thể truy vấn thông tin chi tiết một giao dịch, danh sách giao dịch, đếm số lượng giao dịch.

Bạn có thể làm gì với Giao dịch?

SePay cho phép bạn thực hiện những truy vấn sau với Giao dịch:

GET
https://my.sepay.vn/userapi/transactions/list
  • Lấy danh sách giao dịch
GET
https://my.sepay.vn/userapi/transactions/details/{transaction_id}
  • Lấy chi tiết một giao dịch
GET
https://my.sepay.vn/userapi/transactions/count
  • Đếm số lượng giao dịch

Lấy danh sách giao dịch

Thông tin

Lấy tất cả giao dịch. Mặc định chỉ hiển thị 5000 giao dịch gần nhất.

GET
https://my.sepay.vn/userapi/transactions/list
Tham số truy vấn
statusinteger

Mã HTTP status

errorstring

Thông báo lỗi (null nếu thành công)

messagesobject
transactionsarray<object>
Code mẫu
>
>
>
curl --request GET \
  --url 'https://my.sepay.vn/userapi/transactions/list?account_number=0071000888888&transaction_date_min=2023-04-30&transaction_date_max=2023-05-02&since_id=49050&limit=100&reference_number=171158.050523.060001&amount_in=16848000&amount_out=500000' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
Response
Response 200 - Danh sách giao dịch
{
  "status": 200,
  "error": null,
  "messages": {
    "success": true
  },
  "transactions": [
    {
      "id": "49682",
      "bank_brand_name": "Vietcombank",
      "account_number": "0071000888888",
      "transaction_date": "2023-05-05 19:59:48",
      "amount_out": "0.00",
      "amount_in": "18067000.00",
      "accumulated": "1200541768.00",
      "transaction_content": "DUONG THUY ANH chuyen tien...",
      "reference_number": "677760.050523.080001",
      "code": null,
      "sub_account": "VCB0011ABC004",
      "bank_account_id": "19"
    }
  ]
}
statusinteger

Mã HTTP status

errorstring

Thông báo lỗi (null nếu thành công)

messagesobject
transactionsarray<object>
Ví dụ sử dụng

Lấy giao dịch sau 08h00 ngày 30/04/2023 và trước 12h00 ngày 02/05/2023

JScURL
1
2
3
curl -X GET "https://my.sepay.vn/userapi/transactions/list?transaction_date_min=2023-04-30%2008:00:00&transaction_date_max=2023-05-02%2012:00:00" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Lấy giao dịch từ ID 49050 trở về sau

JScURL
1
2
3
curl -X GET "https://my.sepay.vn/userapi/transactions/list?since_id=49050" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Lấy 20 giao dịch gần đây của tài khoản ngân hàng số 0071000888888

JScURL
1
2
3
curl -X GET "https://my.sepay.vn/userapi/transactions/list?account_number=0071000888888&limit=20" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Lọc giao dịch có mã tham chiếu là 171158.050523.060001

JScURL
1
2
3
curl -X GET "https://my.sepay.vn/userapi/transactions/list?reference_number=171158.050523.060001" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Lấy các giao dịch với số tiền chuyển vào là 16,848,000

JScURL
1
2
3
curl -X GET "https://my.sepay.vn/userapi/transactions/list?amount_in=16848000" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Lấy chi tiết một giao dịch

GET
https://my.sepay.vn/userapi/transactions/details/{transaction_id}

Lấy thông tin chi tiết một giao dịch theo ID.

Tham số đường dẫn
statusinteger

Mã HTTP status

errorstring

Thông báo lỗi (null nếu thành công)

messagesobject
transactionobject
Code mẫu
>
>
>
curl --request GET \
  --url https://my.sepay.vn/userapi/transactions/details/48673 \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
Response
Response 200 - Chi tiết giao dịch
{
  "status": 200,
  "error": null,
  "messages": {
    "success": true
  },
  "transaction": {
    "id": "48673",
    "transaction_date": "2023-05-04 11:59:47",
    "account_number": "0071000888888",
    "sub_account": "VCB0011ABC002",
    "amount_in": "19689000.00",
    "amount_out": "0.00",
    "accumulated": "1128200335.00",
    "code": null,
    "transaction_content": "TRAN THIEN THAO chuyen tien...",
    "reference_number": "731086.040523.120001",
    "bank_brand_name": "Vietcombank",
    "bank_account_id": "19"
  }
}
statusinteger

Mã HTTP status

errorstring

Thông báo lỗi (null nếu thành công)

messagesobject
transactionobject

Đếm số lượng giao dịch

GET
https://my.sepay.vn/userapi/transactions/count

Đếm tổng số lượng giao dịch.

Tham số truy vấn
statusinteger

Mã HTTP status

errorstring

Thông báo lỗi (null nếu thành công)

messagesobject
count_transactionsinteger

Tổng số giao dịch

Code mẫu
>
>
>
curl --request GET \
  --url 'https://my.sepay.vn/userapi/transactions/count?account_number=0071000888888&transaction_date_min=2023-04-30&transaction_date_max=2023-05-02&since_id=49050' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
Response
Response 200 - Số lượng giao dịch
{
  "status": 200,
  "error": null,
  "messages": {
    "success": true
  },
  "count_transactions": 2322
}
statusinteger

Mã HTTP status

errorstring

Thông báo lỗi (null nếu thành công)

messagesobject
count_transactionsinteger

Tổng số giao dịch

Ví dụ sử dụng

Đếm tổng số lượng giao dịch của tài khoản ngân hàng 0071000888888.

JScURL
1
2
3
curl -X GET "https://my.sepay.vn/userapi/transactions/count?account_number=0071000888888" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Xử lý lỗi

401Unauthorized

Token không hợp lệ hoặc thiếu.

404Not Found

Không tìm thấy giao dịch.

429Too Many Requests

Vượt quá giới hạn 2 request/giây. Kiểm tra header x-sepay-userapi-retry-after.

Trước
—
Tiếp theo
—