Skip to main content
GET
Get a payout
v1 · Base URL https://api.fintoc.com/v1

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Unique identifier of the payout to retrieve.

Response

The payout.

A payout is a transfer of funds Fintoc settles to a recipient bank account. Each payout groups the payment intents, charges, and refunds it disburses or discounts.

id
string
required

Unique identifier of the payout.

Example:

"po_BO381oEATXonG6bj"

object
any
required

Type of the object. Always payout.

amount
integer
required

Value disbursed, in the smallest unit of the currency. CLP has no decimals, so amounts are in pesos. MXN amounts are in centavos.

Example:

550000

created_at
string<date-time>
required

ISO 8601 timestamp, in UTC, of when Fintoc created the payout.

Example:

"2026-03-04T14:10:00Z"

currency
string
required

Three-letter ISO 4217 currency code, returned in uppercase.

Example:

"CLP"

mode
enum<string>
required

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

Available options:
test,
live
Example:

"live"

recipient_account
object
required

Bank account that receives the payout.

status
enum<string>
required

Status of the payout. One of in_progress (Fintoc is processing the transfer), succeeded (the funds reached the recipient account), canceled (the payout failed or was canceled before sending the funds), or returned (the receiving institution returned the funds).

Available options:
in_progress,
succeeded,
canceled,
returned
Example:

"succeeded"

succeeded_at
string<date-time> | null
required

ISO 8601 timestamp, in UTC, of when the payout succeeded. null until the payout succeeds.

Example:

"2026-03-05T12:00:00Z"

updated_at
string<date-time>
required

ISO 8601 timestamp, in UTC, of when Fintoc last updated the payout.

Example:

"2026-03-05T12:00:00Z"