> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Refund object

A `Refund` object represents a refund transaction within the Fintoc payment system.

```json theme={null}
{
  "id": "re_3MjTCxEhuqCR3lNz1NgprEoI",
  "object": "refund",
  "amount": 100,
  "created_at": "2021-10-15T15:23:11.474Z",
  "currency": "clp",
  "metadata": {},
  "mode": "live",
  "resource_id": "pi_3MjTCxEhuqCR3lNz1FLrtTeH",
  "resource_type": "payment_intent",
  "status": "succeeded",
  "updated_at": "2021-11-15T12:23:11.474Z"
}
```

| Attribute       | Type      | Description                                                                                                                                                                                           |
| :-------------- | :-------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`            | `string`  | Unique identifier for the Refund object.                                                                                                                                                              |
| `object`        | `string`  | String representing the object's type. Its value for refunds will always correspond to `refund`.                                                                                                      |
| `amount`        | `integer` | Amount to refund, represented as an integer. This value must always be greater than 0, and less than or equal to the corresponding PaymentIntent amount. Defaults to the entire PaymentIntent amount. |
| `created_at`    | `string`  | Refund's creation date, using ISO 8601 format.                                                                                                                                                        |
| `currency`      | `string`  | ISO 4217 currency code. Currently supports `CLP` and `MXN`.                                                                                                                                           |
| `metadata`      | `hash`    | Set of [key-value](/v2023-11-15/reference/fintoc-api/metadata) pairs for storing additional structured information about the object.                                                                  |
| `mode`          | `string`  | Indicates whether the Refund is in `live` mode or `test` mode (sandbox). Depends on the original object's mode.                                                                                       |
| `resource_id`   | `string`  | References the `PaymentIntent` ID to be refunded.                                                                                                                                                     |
| `resource_type` | `string`  | Can take one possible value: `PaymentIntent`.                                                                                                                                                         |
| `status`        | `string`  | Refund status. Can be `created`, `in_progress`, `succeeded`, `failed`, or `canceled`.                                                                                                                 |
| `updated_at`    | `string`  | Refund object's last updated date, using ISO 8601 format.                                                                                                                                             |

## Refund statuses

| Status        | Description                                                                                         |
| :------------ | :-------------------------------------------------------------------------------------------------- |
| `created`     | The refund has been created and will start processing at 18:00 of the closest business day.         |
| `in_progress` | The refund is processing and should arrive to your customer's bank account in 1 or 2 business days. |
| `succeeded`   | The refund has been transferred successfully to your customer's account.                            |
| `failed`      | An error occurred while processing the refund.                                                      |
| `canceled`    | The merchant requested to cancel a created refund.                                                  |