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