The Dispute object represents a card payment your customer has contested with their issuer, also known as a chargeback. Fintoc returns it in Disputes API responses and in dispute webhook events. The status field tracks the dispute from waiting_documentation through in_review to a final won, lost, or expired.
| Attribute | Type | Description |
|---|---|---|
id | string | Unique identifier of the dispute. Prefixed with cb_. |
object | string | Type of the object. Always dispute. |
amount | integer | Disputed amount, in the currency's smallest unit. CLP has no decimals, so 7005 means 7005 CLP; MXN and USD have cents, so 7005 means 70.05. |
created_at | string | ISO 8601 datetime in UTC when the dispute was created. |
currency | string | ISO 4217 currency code of the disputed amount. |
documentation_upload_deadline | string | ISO 8601 datetime in UTC for the documentation submission deadline before the dispute is lost by default. |
documents | array | Documents uploaded as evidence for the dispute. |
mode | string | One of live or test. |
resource_id | string | Identifier of the disputed resource. |
resource_type | string | Type of the disputed resource. Always payment_intent. |
status | string | Current status of the dispute. One of waiting_documentation, in_review, lost, expired, or won. |
updated_at | string | ISO 8601 datetime in UTC when the dispute was last updated. |
{
"id": "cb_8anBm9YpVwXzKqL2",
"object": "dispute",
"amount": 7005,
"created_at": "2024-01-15T17:04:10.284Z",
"currency": "CLP",
"documentation_upload_deadline": "2024-01-22T17:04:10.284Z",
"documents": [
{
"id": "cbd_8anBm9YpVwXzKqL2",
"object": "dispute_document",
"content_type": "application/pdf",
"created_at": "2024-01-16T17:04:10.284Z",
"dispute_id": "cb_8anBm9YpVwXzKqL2",
"filename": "evidence.pdf",
"size": 102400
}
],
"mode": "live",
"resource_id": "pi_8anBm9YpVwXzKqL2",
"resource_type": "payment_intent",
"status": "waiting_documentation",
"updated_at": "2024-01-16T17:04:10.284Z"
}