API lấy danh sách hoàn tiền

Danh sách hoàn tiền

GET

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

Trả về lệnh hoàn tiền của một tài khoản ngân hàng, mới nhất trước.

Tham số

ba_xidstringrequired

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

orderstring

Lọc theo UUID đơn hàng

transactionstring

Lọc theo ID giao dịch thu hộ

statusenum

Lọc theo trạng thái hoàn tiền

pageinteger

Trang (mặc định: 1)

Mặc định: 1

per_pageinteger

Số bản ghi mỗi trang, 1-100 (mặc định: 20)

Mặc định: 20

Lọc để đối soát

Lọc status=pending để tìm các lệnh chưa có kết quả, status=succeeded để đối soát số tiền đã hoàn thực tế. Lọc transaction khi cần xem một khoản thu đã bị hoàn bao nhiêu lần.

Code mẫu

curl --request GET \
  --url 'https://userapi.sepay.vn/v2/bank-accounts/f9e8d7c6-b5a4-3210-fedc-ba0987654321/refunds?order=SOME_STRING_VALUE&transaction=SOME_STRING_VALUE&status=SOME_STRING_VALUE&page=SOME_INTEGER_VALUE&per_page=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response (HTTP 200)

Response 200 - Danh sách hoàn tiền

{
  "status": "success",
  "data": [
    {
      "refund_id": "RF-7QK3-M8PZ-4VNW",
      "order_type": "va_order",
      "order_id": "string",
      "order_code": "string",
      "xid": "string",
      "transaction_id": "string",
      "original_reference": "string",
      "amount": 50000,
      "currency": "VND",
      "scope": "full",
      "status": "pending",
      "created_at": "2026-08-28 14:05:00"
    }
  ],
  "meta": {
    "pagination": {
      "total": 0,
      "per_page": 0,
      "current_page": 0,
      "last_page": 0,
      "has_more": true
    }
  }
}

statusstring

dataarray<object>

metaobject

Ghi chú

refund_id là mã tra cứu lệnh hoàn, dùng cho Chi tiết hoàn tiền
amount là số nguyên (VND)
order_id và order_code là null với lệnh hoàn không có đơn hàng phía sau
Lọc status bằng giá trị ngoài danh sách cho phép trả 422