> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 争议

## 事件列表

| **事件名称** | **事件类型**            | **触发时机**                  | **通知数据结构**                       |
| -------- | ------------------- | ------------------------- | -------------------------------- |
| 争议创建通知   | v2.disputes.created | 争议首次创建时                   | [Dispute](/zh/webhook/dispute-2) |
| 争议更新通知   | v2.disputes.updated | 争议关键字段（状态、原因、金额、截止时间等）变化时 | [Dispute](/zh/webhook/dispute-2) |

## 事件对象

| **属性**                | **类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                  | **示例**                     |
| --------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| id                    | string | Subotiz 争议 ID                                                                                                                                                                                                                                                                                                                                                                                                           | 583570323576728234         |
| channel\_dispute\_id  | string | 渠道争议 ID                                                                                                                                                                                                                                                                                                                                                                                                                 | dp\_1OqFkP2eZvKYlo2C       |
| merchant\_id          | string | 商户 ID                                                                                                                                                                                                                                                                                                                                                                                                                   | 100010                     |
| order\_id             | string | 交易单 ID                                                                                                                                                                                                                                                                                                                                                                                                                  | order\_1769076135405830680 |
| payment\_channel      | string | 支付渠道                                                                                                                                                                                                                                                                                                                                                                                                                    | stripe                     |
| payment\_method       | string | 支付方式                                                                                                                                                                                                                                                                                                                                                                                                                    | card                       |
| dispute\_status       | string | 争议状态：<br />`inquiry_needs_response` - 待商家回应（查询）<br />`inquiry_under_review` - 审核中（查询）<br />`case_closed` - 已关闭<br />`needs_response` - 待商家回应<br />`under_review` - 审核中<br />`won` - 争议胜诉<br />`lost` - 争议败诉<br />`open` - 尚未解决<br />`pending_customer_response` - 待客户回应<br />`needs_response_appealable` - 待商家回应（可申诉）                                                                                                   | needs\_response            |
| dispute\_reason       | string | 争议原因：<br />`unauthorized` - 客户未授权购买商品或服务<br />`product_not_received` - 客户未收到商品或服务<br />`product_unacceptable` - 客户报告商品或服务与描述不符<br />`credit_not_processed` - 未为客户处理退款或信贷<br />`duplicate` - 交易重复<br />`subscription_canceled` - 订阅已取消<br />`unrecognized` - 客户无法识别的交易<br />`incorrect_charge_amount` - 收费金额有误<br />`payment_by_other_methods` - 客户通过其他方式付款<br />`remittance_processing_error` - 汇款问题<br />`others` - 其他 | unauthorized               |
| order\_amount         | string | 订单金额                                                                                                                                                                                                                                                                                                                                                                                                                    | 100.00                     |
| order\_currency       | string | 订单币种                                                                                                                                                                                                                                                                                                                                                                                                                    | USD                        |
| dispute\_amount       | string | 争议金额                                                                                                                                                                                                                                                                                                                                                                                                                    | 100.00                     |
| dispute\_currency     | string | 争议币种                                                                                                                                                                                                                                                                                                                                                                                                                    | USD                        |
| dispute\_create\_time | string | 争议创建时间（RFC3339）                                                                                                                                                                                                                                                                                                                                                                                                         | 2026-03-15T08:30:00Z       |
| dispute\_update\_time | string | 最后更新时间（RFC3339）                                                                                                                                                                                                                                                                                                                                                                                                         | 2026-03-15T08:30:00Z       |
| dispute\_due\_time    | string | 回应截止日（RFC3339）                                                                                                                                                                                                                                                                                                                                                                                                          | 2026-03-22T08:30:00Z       |

## 示例

<CodeGroup>
  ```json v2.disputes.created theme={null}
  {
    "id": "583570323576728234",
    "type": "v2.disputes.created",
    "created": "2026-03-15T08:30:00Z",
    "data": {
      "id": "583570323576728234",
      "channel_dispute_id": "dp_1OqFkP2eZvKYlo2C",
      "merchant_id": "100010",
      "order_id": "order_1769076135405830680",
      "payment_channel": "stripe",
      "payment_method": "card",
      "dispute_status": "needs_response",
      "dispute_reason": "unauthorized",
      "order_amount": "100.00",
      "order_currency": "USD",
      "dispute_amount": "100.00",
      "dispute_currency": "USD",
      "dispute_create_time": "2026-03-15T08:30:00Z",
      "dispute_update_time": "2026-03-15T08:30:00Z",
      "dispute_due_time": "2026-03-22T08:30:00Z"
    }
  }
  ```

  ```json v2.disputes.updated theme={null}
  {
    "id": "583570323576728235",
    "type": "v2.disputes.updated",
    "created": "2026-03-18T10:15:00Z",
    "data": {
      "id": "583570323576728234",
      "channel_dispute_id": "dp_1OqFkP2eZvKYlo2C",
      "merchant_id": "100010",
      "order_id": "order_1769076135405830680",
      "payment_channel": "stripe",
      "payment_method": "card",
      "dispute_status": "under_review",
      "dispute_reason": "unauthorized",
      "order_amount": "100.00",
      "order_currency": "USD",
      "dispute_amount": "100.00",
      "dispute_currency": "USD",
      "dispute_create_time": "2026-03-15T08:30:00Z",
      "dispute_update_time": "2026-03-18T10:15:00Z",
      "dispute_due_time": "2026-03-22T08:30:00Z"
    }
  }
  ```
</CodeGroup>