Disputes
The Dispute resource represents a card dispute that has been raised by an end customer. Disputes occur when a cardholder contests a transaction, typically for reasons such as fraud, unauthorized charges, or goods/services not received.
For detailed information on handling disputes and the dispute lifecycle, see Unit's disputes guide.
Dispute Statuses
Disputes progress through various statuses as they are investigated and resolved:
| Status | Description |
|---|---|
| InvestigationStarted | The dispute has been filed and is under investigation. |
| ProvisionalCredit | The customer has been given temporary credit while the investigation continues. |
| ResolvedWon | The dispute was resolved in favor of the customer. |
| ResolvedLost | The dispute was resolved in favor of the merchant. |
| Denied | The dispute was denied. |
Dispute Types
| Type | Description |
|---|---|
| Fraud | The customer claims the transaction was fraudulent. |
| Unauthorized | The customer did not authorize the transaction. |
| GoodsNotReceived | The customer did not receive the goods or services. |
| Other | Other dispute reasons. |
Related Resources
- APIs - Retrieve and list disputes
- Events - Webhook events for dispute lifecycle changes
- Resources - JSON:API resource schemas
- Simulations - Sandbox simulation endpoints for testing