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

# Overview

> The Dispute object represents a contact dispute or chargeback on a payment transaction.

The Dispute Data Model represents a contact dispute or chargeback on a payment transaction. Disputes occur when contacts contest charges with their bank or card issuer.

* **Chargeback management**: Track disputes from filing through resolution
* **Evidence tracking**: Monitor evidence submission deadlines
* **Reason categorization**: Standardized dispute reason codes
* **Transaction linking**: Connect disputes to original payment transactions

## Attributes

### Disputes Attributes

| Property                  | Type    | Description                                                   |
| ------------------------- | ------- | ------------------------------------------------------------- |
| `rootfi_id`               | integer | Unique identifier for this dispute                            |
| `rootfi_created_at`       | string  | When this dispute was created in Commenda's system (ISO 8601) |
| `rootfi_updated_at`       | string  | When this dispute was last updated (ISO 8601)                 |
| `rootfi_integration_type` | enum    |                                                               |
| `platform_id`             | string  | Platform-specific dispute identifier                          |
| `transaction_id`          | string  | Reference to the disputed Transaction                         |
| `invoice_id`              | string  | Reference to the related Invoice                              |
| `contact_id`              | string  | Reference to the Contact                                      |
| `currency_id`             | enum    | ISO 4217 currency code                                        |
| `amount`                  | double  | Disputed amount                                               |
| `status`                  | enum    | Current dispute status                                        |
| `reason`                  | enum    | Standardized dispute reason                                   |
| `reason_code`             | string  | Platform-specific reason code                                 |
| `gateway`                 | string  | Payment gateway name                                          |
| `gateway_dispute_id`      | string  | Platform-specific dispute ID                                  |
| `evidence_due_date`       | string  | Deadline for submitting evidence (ISO 8601)                   |
| `resolution_date`         | string  | Date dispute was resolved (null if pending) (ISO 8601)        |
| `created_at`              | string  | Original dispute creation timestamp (ISO 8601)                |
| `updated_at`              | string  | Last update timestamp (ISO 8601)                              |

### Status Enum Values

| Value            | Description                        |
| ---------------- | ---------------------------------- |
| `OPEN`           | Dispute has been filed and is open |
| `UNDER_REVIEW`   | Platform is reviewing evidence     |
| `WON`            | Merchant won the dispute           |
| `LOST`           | Contact won the dispute            |
| `WARNING_CLOSED` | Closed with a warning              |
| `UNKNOWN`        | Status cannot be determined        |

### Reason Enum Values

| Value           | Description                           |
| --------------- | ------------------------------------- |
| `FRAUDULENT`    | Transaction was fraudulent            |
| `DUPLICATE`     | Duplicate charge                      |
| `UNRECOGNIZED`  | Contact doesn't recognize transaction |
| `QUALITY_ISSUE` | Product/service quality issue         |
| `NOT_RECEIVED`  | Product not received                  |
| `CANCELED`      | Service was canceled                  |
| `OTHER`         | Other reason                          |