v1

latestOpenAPI 3.1.02026-07-228956435.8 KB

Refunds

List refunds

Lists the refunds of your organization for the live or test mode of the API key used. Use since, until, and status to filter the results.

get/refunds

Query parameters

sincestring

Example:2026-01-01T00:00:00.000Z

Filters refunds created on or after this ISO 8601 date-time, in UTC.

untilstring

Example:2026-02-01T00:00:00.000Z

Filters refunds created on or before this ISO 8601 date-time, in UTC.

status'pending' | 'in_progress' | 'succeeded' | 'failed' | 'canceled'

Example:succeeded

Filters refunds by their current status.

per_pageinteger

Number of refunds per page. Defaults to 30. The maximum is 300.

pageinteger

Page number to retrieve. Starts at 1.

Response

List of refunds for the current mode.

idstring required

Unique identifier of the refund.

object'refund' required

Type of the object. Always refund.

amountinteger required

Amount refunded, as an integer in the smallest unit of currency (for example, 5000 for $5000 CLP, since CLP has no minor unit).

created_atstring date-time required

ISO 8601 timestamp of when the refund was created.

currency'CLP' | 'MXN' required

Three-letter ISO 4217 currency code. Always matches the currency of the refunded resource.

failure_codestring nullable required

Reason why the refund failed. One of fraud_risk (the disbursement was blocked by Fintoc's fraud checks) or insufficient_funds (your organization did not have enough funds to cover the refund). null unless the refund failed.

metadataobject required

Set of key-value pairs attached to the refund when it was created.

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

ID of the refunded resource.

resource_type'payment_intent' required

Type of the refunded resource. Always payment_intent.

status'pending' | 'in_progress' | 'succeeded' | 'failed' | 'canceled' required

Current status of the refund. One of pending (the disbursement has not started), in_progress (Fintoc is disbursing the funds), succeeded (the funds reached the recipient account), failed (the disbursement failed; see failure_code), or canceled (the refund was canceled before disbursing).

updated_atstring date-time required

ISO 8601 timestamp of when the refund was last updated.

Example response

[
  {
    "id": "ref_8XzNbCv1LqKjWp4R",
    "amount": 5000,
    "created_at": "2026-03-04T17:04:10Z",
    "currency": "CLP",
    "metadata": {
      "order_id": "9182"
    },
    "mode": "live",
    "recipient_account": {
      "holder_id": "111111111",
      "holder_name": "Jane Doe",
      "institution_id": "cl_banco_de_chile",
      "number": "123456789",
      "type": "checking_account"
    },
    "resource_id": "pi_jsperFI9bnyM2RTo",
    "resource_type": "payment_intent",
    "status": "succeeded",
    "updated_at": "2026-03-04T17:04:10Z"
  }
]