Overview - Integrations by Commenda

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