事件列表

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

事件对象

属性	类型	描述	示例
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	争议状态： `inquiry_needs_response` - 待商家回应（查询） `inquiry_under_review` - 审核中（查询） `case_closed` - 已关闭 `needs_response` - 待商家回应 `under_review` - 审核中 `won` - 争议胜诉 `lost` - 争议败诉 `open` - 尚未解决 `pending_customer_response` - 待客户回应 `needs_response_appealable` - 待商家回应（可申诉）	needs_response
dispute_reason	string	争议原因： `unauthorized` - 客户未授权购买商品或服务 `product_not_received` - 客户未收到商品或服务 `product_unacceptable` - 客户报告商品或服务与描述不符 `credit_not_processed` - 未为客户处理退款或信贷 `duplicate` - 交易重复 `subscription_canceled` - 订阅已取消 `unrecognized` - 客户无法识别的交易 `incorrect_charge_amount` - 收费金额有误 `payment_by_other_methods` - 客户通过其他方式付款 `remittance_processing_error` - 汇款问题 `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

示例

{
  "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"
  }
}

{
  "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"
  }
}