Sign in

v1

latestOpenAPI 3.1.02026-07-228956435.8 KB
Disputes

Submit a dispute for review

Submits the uploaded documentation of a dispute for review. The dispute must be in waiting_documentation, have at least one document, and be within its documentation upload deadline. On success the dispute moves to in_review and Fintoc's operations team is notified.

post/disputes/{id}/submit_for_review

Path parameters

idstring required

Unique identifier for the dispute to submit for review.

Response

The dispute, now in in_review.

idstring required

Unique identifier of the dispute.

object'dispute' required

Type of the object. Always dispute.

amountinteger required

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_atstring date-time required

ISO 8601 datetime in UTC when the dispute was created.

currencystring required

ISO 4217 currency code of the disputed amount.

documentation_upload_deadlinestring date-time required

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

mode'test' | 'live' required

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

resource_idstring required

Identifier of the disputed resource.

resource_type'payment_intent' required

Type of the disputed resource. Always payment_intent.

status'waiting_documentation' | 'in_review' | 'lost' | 'expired' | 'won' required

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

updated_atstring date-time required

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

Example response

{
  "id": "cb_8anBm9YpVwXzKqL2",
  "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",
      "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",
  "status": "waiting_documentation",
  "updated_at": "2024-01-16T17:04:10.284Z"
}