API lấy danh sách VA theo đơn hàng

Lấy danh sách đơn hàng VA qua SePay API cho tài khoản BIDV, Sacombank, Vietcombank hoặc VietinBank. Hỗ trợ phân trang và sắp xếp theo ngày tạo.

||

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",
      "refund_status": null,
      "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)