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.

{
  "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, 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
`number`	`string`	Account number. Does not include hyphens or prefixed zeros
`type`	`string`	Account type. It can be `checking_account` or `sight_account`