查询退款单列表

GET 
/openapi/2025-06/shoplazza-payment/refunds

分页返回退款单列表，可按状态和创建时间范围过滤。

请求

Query参数

cursor string

分页游标

page_size int32

每页记录数（1-100，默认 10）

status string
按状态筛选退款单：
• succeeded: 退款处理成功
• failed: 退款失败，未退回资金
• processing: 退款处理中，最终结果待确认
created_at_min string

按发起时间过滤的起始值。支持 Unix 时间（如 1730548810）或 ISO 时间字符串（如 2018-11-02T12:30:10Z）

created_at_max string

按发起时间过滤的结束值。支持 Unix 时间（如 1730548810）或 ISO 时间字符串（如 2018-11-02T12:30:10Z）

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

list object[]

退款单记录列表

Array [

idstring

退款 ID

store_idstring

与退款关联的店铺 ID

balance_currencystring

余额使用的货币

transaction_order_idstring

与退款关联的交易订单 ID

statusstring

退款状态：

• succeeded: 退款成功
• failed: 退款失败
• processing: 退款处理中

amountstring

退款金额

currencystring

退款的货币代码（如 USD）

original_order_amountstring

退款前的原始订单金额

created_atstring

退款创建时间（ISO-8601 格式）

completed_atstring

退款完成时间（ISO-8601 格式）

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "id": "string",
        "store_id": "string",
        "balance_currency": "string",
        "transaction_order_id": "string",
        "status": "string",
        "amount": "string",
        "currency": "string",
        "original_order_amount": "string",
        "created_at": "string",
        "completed_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}