Event List

Event Name	Event Type	Trigger Condition	Data Structure
Dispute Created	v2.disputes.created	When a dispute is first created	Dispute
Dispute Updated	v2.disputes.updated	When key fields of an existing dispute change	Dispute

Event Object

Field	Type	Description	Example
id	string	Subotiz dispute ID	583570323576728234
channel_dispute_id	string	Channel-side dispute ID	dp_1OqFkP2eZvKYlo2C
merchant_id	string	Merchant ID	100010
order_id	string	Trade order ID	order_1769076135405830680
payment_channel	string	Payment channel	stripe
payment_method	string	Payment method	card
dispute_status	string	Dispute status: `inquiry_needs_response` - Awaiting merchant response (inquiry) `inquiry_under_review` - Under review (inquiry) `case_closed` - Closed `needs_response` - Awaiting merchant response `under_review` - Under review `won` - Dispute won `lost` - Dispute lost `open` - Open `pending_customer_response` - Awaiting customer response `needs_response_appealable` - Awaiting merchant response (appealable)	needs_response
dispute_reason	string	Dispute reason: `unauthorized` - The customer did not authorize the purchase `product_not_received` - The customer did not receive the product or service `product_unacceptable` - The product or service does not match the description `credit_not_processed` - A promised refund or credit was not processed `duplicate` - The transaction was duplicated `subscription_canceled` - The subscription was canceled `unrecognized` - The customer does not recognize the transaction `incorrect_charge_amount` - The charged amount is incorrect `payment_by_other_methods` - The customer paid through another method `remittance_processing_error` - Remittance processing issue `others` - Other reasons	unauthorized
order_amount	string	Order amount	100.00
order_currency	string	Order currency	USD
dispute_amount	string	Dispute amount	100.00
dispute_currency	string	Dispute currency	USD
dispute_create_time	string	Dispute creation time (RFC3339)	2026-03-15T08:30:00Z
dispute_update_time	string	Last update time (RFC3339)	2026-03-15T08:30:00Z
dispute_due_time	string	Response due time (RFC3339)	2026-03-22T08:30:00Z

Example

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