跳转到主要内容
GET
List refunds
请使用属于目标组织的 API 密钥进行认证。 每笔退款的字段与 refund.succeeded、refund.failed Webhook 相同,事件和 API 读取可以用同一套代码对账。status 为 succeeded、failed 或 pending(仍在审核或处理中)。pending 不会发送 Webhook;退款结束时会发送 refund.succeeded 或 refund.failed。 按时间段对账时,使用 date_from 和 date_to 筛选并逐页读取。查看某个订单的全部退款时, 使用 order_id 筛选。totalRefundedCents 和 fullyRefunded 反映请求时订单的状态。Webhook 中的这两个字段是事件发生时的值;同一订单之后又有退款成功时,API 返回的合计会高于之前那条 Webhook。

授权

X-API-Key
string
header
必填

Merchant API key (format: ak_BASE64)

查询参数

page
integer
默认值:1

Page number

size
integer
默认值:20

Page size (max 100)

order_id
string

Filter by order ID (ORD_...)

status
string

succeeded, failed or pending

date_from
integer

Refunds requested at or after this unix timestamp

date_to
integer

Refunds requested at or before this unix timestamp

响应

OK

data
object
error
object
message
string
success
boolean