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

# Dispute

## Event List

| **Event Name**  | **Event Type**      | **Trigger Condition**                         | **Data Structure**               |
| :-------------- | :------------------ | :-------------------------------------------- | :------------------------------- |
| Dispute Created | v2.disputes.created | When a dispute is first created               | [Dispute](/en/webhook/dispute-2) |
| Dispute Updated | v2.disputes.updated | When key fields of an existing dispute change | [Dispute](/en/webhook/dispute-2) |

## 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:<br />`inquiry_needs_response` - Awaiting merchant response (inquiry)<br />`inquiry_under_review` - Under review (inquiry)<br />`case_closed` - Closed<br />`needs_response` - Awaiting merchant response<br />`under_review` - Under review<br />`won` - Dispute won<br />`lost` - Dispute lost<br />`open` - Open<br />`pending_customer_response` - Awaiting customer response<br />`needs_response_appealable` - Awaiting merchant response (appealable)                                                                                                                                                                                                                                                                                         | needs\_response            |
| dispute\_reason       | string   | Dispute reason:<br />`unauthorized` - The customer did not authorize the purchase<br />`product_not_received` - The customer did not receive the product or service<br />`product_unacceptable` - The product or service does not match the description<br />`credit_not_processed` - A promised refund or credit was not processed<br />`duplicate` - The transaction was duplicated<br />`subscription_canceled` - The subscription was canceled<br />`unrecognized` - The customer does not recognize the transaction<br />`incorrect_charge_amount` - The charged amount is incorrect<br />`payment_by_other_methods` - The customer paid through another method<br />`remittance_processing_error` - Remittance processing issue<br />`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

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