API lấy chi tiết hoàn tiền

Tra cứu một lệnh hoàn tiền theo refund_id qua SePay API, xem trạng thái xử lý và thông tin ngân hàng trả về cho lần hoàn đó.

||

Chi tiết hoàn tiền

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

Tra cứu theo refund_id nhận được khi tạo lệnh hoàn.

Tham số

ba_xidstringrequired

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

refund_idstringrequired

Mã hoàn tiền do SePay cấp

Code mẫu

>
>
>
curl --request GET \
--url https://userapi.sepay.vn/v2/bank-accounts/f9e8d7c6-b5a4-3210-fedc-ba0987654321/refunds/RF-7QK3-M8PZ-4VNW \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response (HTTP 200)

Response 200 - Chi tiết 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"
  }
}
statusstring
dataobject
Trạng thái tự cập nhật

SePay tự hỏi lại ngân hàng cho các lệnh còn pending, bạn không cần gọi sang ngân hàng. Khi status đã là succeeded, failed hoặc rejected thì đó là kết quả cuối và không đổi nữa.

Đối chiếu với ngân hàng

Response không kèm mã kỹ thuật phía ngân hàng. Khi cần đối chiếu một lệnh hoàn với VietinBank, gửi refund_id cho SePay để được tra cứu.