跳到主要内容
版本:202201

查询争议单列表

GET 

/openapi/2024-07/shoplazza-payment/disputes

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

请求

Query参数

    cursor string

    分页游标。

    limit int32

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 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)。

响应

OK

数据结构
    codestring

    error code

    messagestring

    error message

    data object

    Response: Dispute order list

    has_moreboolean

    是否有更多记录。

    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

    分页游标。