Saltar al contenido principal
GET
List disputes
v1 · Base URL https://api.fintoc.com/v1

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

status
string

Filter by dispute status. One of waiting_documentation, in_review, won, lost, expired. Accepts a comma-separated list.

resource_id
string

Filter by the id of the disputed resource (the payment intent).

since
string

ISO 8601 datetime in UTC that filters disputes created on or after the provided time.

until
string

ISO 8601 datetime in UTC that filters disputes created on or before the provided time.

Respuesta

List of disputes for the current mode, most recent first.

id
string
requerido

Unique identifier of the dispute.

Ejemplo:

"cb_8anBm9YpVwXzKqL2"

object
any
requerido

Type of the object. Always dispute.

amount
integer
requerido

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.

Ejemplo:

7005

created_at
string<date-time>
requerido

ISO 8601 datetime in UTC when the dispute was created.

Ejemplo:

"2024-01-15T17:04:10.284Z"

currency
string
requerido

ISO 4217 currency code of the disputed amount.

Ejemplo:

"CLP"

documentation_upload_deadline
string<date-time>
requerido

ISO 8601 datetime in UTC for the documentation submission deadline before the dispute is lost by default.

Ejemplo:

"2024-01-22T17:04:10.284Z"

documents
object[]
requerido

Documents uploaded as evidence for the dispute.

mode
enum<string>
requerido

Mode of the object. live objects use real institution data, test objects use fake data for integration testing.

Opciones disponibles:
test,
live
Ejemplo:

"live"

resource_id
string
requerido

Identifier of the disputed resource.

Ejemplo:

"pi_8anBm9YpVwXzKqL2"

resource_type
any
requerido

Type of the disputed resource. Always payment_intent.

status
enum<string>
requerido

Current status of the dispute. One of waiting_documentation, in_review, lost, expired, or won.

Opciones disponibles:
waiting_documentation,
in_review,
lost,
expired,
won
Ejemplo:

"waiting_documentation"

updated_at
string<date-time>
requerido

ISO 8601 datetime in UTC when the dispute was last updated.

Ejemplo:

"2024-01-16T17:04:10.284Z"