The Dispute object

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.

Dispute Object

{
  "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"
}

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

The Dispute object