> ## 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.

# Payout object

## The Payout object

The `Payout` object represents a transfer of collected funds from Fintoc to your bank account. It appears in Payouts API responses and in payout webhook events, and its `status` field tracks the disbursal through `in_progress`, `succeeded`, `canceled`, and `returned`.

```json Payout Object theme={null}
{
  "id": "po_6qMelax3udMp0bDR",
  "object": "payout",
  "amount": 49632342,
  "created_at": "2021-10-15T15:23:11.474Z",
  "currency": "CLP",
  "mode": "live",
  "recipient_account": {
    "holder_id": "555555555",
    "institution_id": "cl_banco_security",
    "number": "9213610",
    "type": "checking_account"
  },
  "status": "succeeded",
  "succeeded_at": "2021-10-15T15:24:15.474Z",
  "updated_at": "2021-10-15T15:23:11.474Z"
}
```

| Attribute           | Type      | Description                                                                                                                 |
| :------------------ | :-------- | :-------------------------------------------------------------------------------------------------------------------------- |
| `id`                | `string`  | Unique identifier for the payout.                                                                                           |
| `object`            | `string`  | Type of the object. Always `payout`.                                                                                        |
| `amount`            | `integer` | Payout amount in the smallest currency unit. Must be greater than `0`.                                                      |
| `created_at`        | `string`  | Payout's creation date, using ISO 8601 format.                                                                              |
| `currency`          | `string`  | [Currency ISO code](https://www.iso.org/iso-4217-currency-codes.html), such as `CLP` or `MXN`.                              |
| `mode`              | `string`  | Indicates whether the `Payout` is in `live` mode or in `test` mode (for the sandbox). Payouts are only supported in `live`. |
| `recipient_account` | `object`  | Recipient bank account for the payout. See the Recipient Account object table below for its fields.                         |
| `status`            | `string`  | Payout status. One of `in_progress`, `succeeded`, `canceled`, or `returned`.                                                |
| `succeeded_at`      | `string`  | Payout's object succeeded date, using ISO 8601 format.                                                                      |
| `updated_at`        | `string`  | Payout's object last updated date, using ISO 8601 format.                                                                   |

### Payout statuses

| Status        | Description                                                                               |
| :------------ | :---------------------------------------------------------------------------------------- |
| `in_progress` | The payout is processing and should arrive to your bank account in the next business day. |
| `succeeded`   | The payout has been transferred successfully to your account.                             |
| `canceled`    | The payout has been canceled.                                                             |
| `returned`    | The payout has been returned.                                                             |

### The Recipient Account object (within the Payout object)

The Recipient Account object describes the bank account that receives the funds, returned in the `recipient_account` field of the Payout.

| Attribute        | Type     | Description                                                                                                                                                          |
| :--------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `holder_id`      | `string` | Account owner's tax ID. In Chile, this value is a Chilean tax ID (RUT). In Mexico, this value is a Mexican tax ID (RFC) or unique population registry code (CURP).   |
| `institution_id` | `string` | Account's institution `id`. You can learn more about institutions and their `id`s [here](https://docs.fintoc.com/docs/payment-initiation-countries-and-institutions) |
| `number`         | `string` | Account number. Does not include hyphens or prefixed zeros                                                                                                           |
| `type`           | `string` | Account type. It can be `checking_account` or `sight_account`                                                                                                        |