查询争议单列表

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

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

请求

Query参数

cursor string

分页游标

page_size int32

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

status string
按状态筛选争议单：
• lost: 争议判定商家败诉，资金未追回
• won: 争议判定商家胜诉，资金保留或已追回
• warning_closed: 预警型争议已关闭，无需进一步处理
• needs_response: 争议需要商家提交回复或证据后才能继续处理
• under_review: 争议正由支付处理方或金融机构审核中
• warning_under_review: 预警型争议审核中，可能需要进一步处理
• warning_needs_response: 预警型争议等待商家回复，否则可能升级
created_at_min string

筛选在该 Unix 时间及之后创建的争议单（如 1730548810）

created_at_max string

筛选在该 Unix 时间及之前创建的争议单（如 1730548810）

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

list object[]

争议单记录列表

Array [

idstring

争议 ID

transaction_order_idstring

与争议相关的交易订单 ID

original_order_idstring

与交易相关的原始订单 ID

store_idstring

店铺 ID

currencystring

争议金额的货币代码

created_atstring

争议创建时间，ISO 8601 格式

updated_atstring

争议最后更新时间，ISO 8601 格式

expiration_timestring

争议回应的截止时间

dispute_reasonstring

发起争议时填写的原因

original_order_amountstring

原始订单的总金额

dispute_amountstring

争议金额

statusstring

争议当前状态，可选值：won（已胜诉）、lost（已败诉）、under_review（审核中）等

feestring

与争议关联的费用

fee_currencystring

关联费用的货币

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "id": "string",
        "transaction_order_id": "string",
        "original_order_id": "string",
        "store_id": "string",
        "currency": "string",
        "created_at": "string",
        "updated_at": "string",
        "expiration_time": "string",
        "dispute_reason": "string",
        "original_order_amount": "string",
        "dispute_amount": "string",
        "status": "string",
        "fee": "string",
        "fee_currency": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}