> ## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.