Danh sách đơn hàng

Lấy danh sách đơn hàng VA của tài khoản BIDV hoặc Sacombank qua SePay API v2.

Danh sách đơn hàng

GET

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

Tham số

ba_xidstringrequired

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

created_at_sortenum

Sắp xếp theo ngày tạo (mặc định: mới nhất trước)

Mặc định: desc

amount_sortenum

Sắp xếp theo số tiền

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/f9e8d7c6-b5a4-3210-fedc-ba0987654321/orders?created_at_sort=SOME_STRING_VALUE&amount_sort=SOME_STRING_VALUE&page=SOME_INTEGER_VALUE&per_page=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response

Response 200 - Danh sách đơn hàng

{
  "status": "success",
  "data": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678902",
      "order_code": "ORD123456789",
      "amount": 1000000,
      "paid_amount": 0,
      "status": "Pending",
      "created_at": "2025-12-18 08:15:00",
      "bank_name": "BIDV",
      "account_number": "1234567890",
      "account_holder_name": "CONG TY CP TECH VINA",
      "va": [
        {
          "va_number": "963NQDORD1234567890AB",
          "va_holder_name": "CONG TY CP TECH VINA",
          "amount": 1000000,
          "status": "Unpaid",
          "expired_at": "2025-12-19 08:15:00",
          "paid_at": null
        }
      ]
    }
  ],
  "meta": {
    "pagination": {
      "total": 25,
      "per_page": 20,
      "current_page": 1,
      "last_page": 2,
      "has_more": true
    }
  }
}

statusstring

dataarray<object>

metaobject

Ghi chú

id là UUID của đơn hàng
amount, paid_amount là integer (VND)
Hỗ trợ BIDV và Sacombank