---
title: "List payout resources"
method: GET
path: "/payouts/{id}/resources"
tags: ["Payouts"]
---

# List payout resources

`GET /payouts/{id}/resources`

Lists the resources that a payout disburses or discounts: payment intents, charges, or refunds. The response item schema depends on `resource_type`: `payment_intent` returns payment intents, `charge` returns charges, and `refund` and `refund_adjustment` return refunds.

## Path parameters

- `id` string, required

## Query parameters

- `resource_type` 'charge' | 'payment_intent' | 'refund' | 'refund_adjustment', required
- `page` integer
- `per_page` integer

## Response `200`

Paginated list of the payout's resources, with the item schema matching `resource_type`. The `Link` and `X-Total-Count` headers carry the pagination information.

- union[]
  - union
    - PaymentIntent
      - `id` string, required — Unique identifier of the payment intent.
      - `object` 'payment_intent', required — Type of the object. Always `payment_intent`.
      - `amount` integer, required — Amount of the payment intent, in the smallest unit of the currency (for example, `100000` for 100000 CLP, since CLP has no minor unit, or `7050` for 70.50 MXN).
      - `business_profile` object, nullable — Profile of the business that collects the payment, when provided. `null` otherwise.
        - `category` string — Category of the business.
        - `name` string — Name of the business.
        - `tax_id` string — Tax identifier of the business.
      - `created_at` string, date-time, required — ISO 8601 timestamp of when the payment intent was created.
      - `currency` 'CLP' | 'MXN', required — Three-letter ISO 4217 currency code of the payment intent. One of `CLP` or `MXN`.
      - `customer` object, nullable, required — Customer associated with the payment intent, when it was created from a checkout session with a customer. `null` otherwise.
        - `id` string — Unique identifier of the customer.
        - `object` 'customer' — Type of the object. Always `customer`.
        - `address` object, nullable — Address of the customer. `null` when not provided.
          - `city` string — City of the address.
          - `country` string — Country of the address.
          - `line1` string — First line of the address.
          - `line2` string — Second line of the address.
          - `postal_code` string — Postal code of the address.
          - `state` string — State of the address.
        - `created_at` string, date-time — ISO 8601 timestamp of when the customer was created.
        - `email` string, nullable — Email address of the customer.
        - `metadata` object — Set of key-value pairs attached to the customer.
        - `mode` string — Mode of the customer. One of `live` or `test`.
        - `name` string, nullable — Name of the customer.
        - `phone` string, nullable — Phone number of the customer.
        - `tax_id` object, nullable — Tax identifier of the customer. `null` when not provided.
          - `type` string — Type of the tax identifier, for example `cl_rut`.
          - `value` string — Value of the tax identifier.
      - `customer_email` string, nullable, required — Email address of the customer that receives payment notifications. `null` when not provided.
      - `error_reason` string, nullable, required — Reason why the payment failed, was rejected, or expired. `null` while the payment is in progress and when it succeeds.
      - `expires_at` string, date-time, nullable, required — ISO 8601 timestamp of when the payment expires and can no longer be paid. Only set for cash payments; `null` otherwise.
      - `metadata` object, required — Set of key-value pairs attached to the payment intent.
      - `mode` 'test' | 'live', required — Mode of the object. `live` objects use real institution data, `test` objects use fake data for integration testing.
      - `next_action` object, nullable, required — Action the customer must complete to continue the payment, as reported by the widget. `null` when no action is pending.
      - `payment_method` string, nullable, required — Identifier of the payment method used to pay, when the payment intent comes from a checkout session or a subscription. `null` otherwise.
      - `payment_type` string, required — Payment type used to pay, such as `bank_transfer` or `cash`.
      - `payment_type_options` object, required — Options specific to the payment type. For card payments, the object contains a `card` object. For cash payments, the object contains a `cash` object with the `reference_number`, `barcode_url`, and `voucher_url` of the payment. For bank transfers, the object is empty.
        - `card` object — Details of the card payment. Present only for card payments.
          - `authenticated_with_3ds` boolean — If `true`, the cardholder completed 3-D Secure authentication for this payment.
          - `bank` string, nullable — Name of the bank that issued the card. `null` when the issuing bank is unknown.
          - `brand` string — Brand of the card.
          - `country` string — Display name of the country where the card was issued, in English.
          - `kind` string — Kind of card. One of `credit`, `debit`, or `prepaid`.
          - `last_four_digits` string, nullable — Last four digits of the card number. `null` when the digits are not available.
          - `wallet` 'apple_pay' | 'google_pay' | 'null', nullable — Digital wallet used for the card payment. One of `apple_pay` or `google_pay`. `null` for cards entered manually.
      - `recipient_account` object, nullable, required — Bank account that receives the payment. `null` for cash payments.
        - `holder_id` string, nullable, required — Tax identifier of the account holder (RUT in Chile, RFC in Mexico).
        - `institution_id` string, nullable, required — Identifier of the institution of the account.
        - `number` string, nullable, required — Number of the account. In Mexico, the CLABE.
        - `type` string, nullable, required — Type of the account, such as `checking_account` or `sight_account`.
      - `reference_id` string, nullable, required — Identifier of the transfer assigned by the institution. `null` until the transfer is executed.
      - `sender_account` object, nullable, required — Bank account the customer pays from. `null` until Fintoc identifies the sender.
        - `holder_id` string, required — Tax identifier of the account holder (RUT in Chile, RFC in Mexico).
        - `institution_id` string, required — Identifier of the institution of the account.
        - `number` string, required — Number of the account.
        - `type` string, required — Type of the account, such as `checking_account` or `sight_account`.
      - `status` 'created' | 'failed' | 'succeeded' | 'rejected' | 'in_progress' | 'pending' | 'expired', required — Status of the payment intent. One of `created` (the customer has not started the payment), `in_progress` (the customer is paying), `succeeded` (the money reached the recipient account), `rejected` (the institution rejected the transfer), `failed` (the payment could not be completed), `expired` (the payment intent expired before being paid), or `pending` (the final status is not yet known; only used if your organization has the pending status enabled).
      - `subscription` string, nullable, required — Identifier of the subscription that originated the payment intent. `null` for one-off payments.
      - `transaction_date` string, date-time, nullable, required — ISO 8601 timestamp of when the institution executed the transfer. `null` until the transfer is executed.
      - `widget_token` string, nullable, required — Token used to initialize the Fintoc widget for this payment intent. Only returned when the payment intent is created; `null` in every other response.
    - SubscriptionsCharge — A charge is a single collection from the bank account of a subscription. You create a charge on an active subscription, and Fintoc collects the charge from the subscription's bank account on the next collection cycle. A charge starts as `pending` and ends as `succeeded`, `failed`, or `canceled`.
      - `id` string, required — Unique identifier of the charge.
      - `object` 'charge', required — Type of the object. Always `charge`.
      - `amount` integer, required — A positive integer in the smallest unit of `currency` (for example, `1000` for `$1000 CLP`, since CLP has no minor unit).
      - `created_at` string, date-time, required — ISO 8601 timestamp of when the charge was created.
      - `currency` string, required — Three-letter ISO 4217 currency code. `CLP` is the only supported currency.
      - `failure_code` 'insufficient_funds' | 'subscription_inactive' | 'charge_amount_limit_exceeded' | 'bank_account_unavailable' | 'other' | 'null', nullable, required — Reason why the charge failed. Always `null` unless `status` is `failed`. One of `insufficient_funds` (the bank account did not have enough funds), `subscription_inactive` (the subscription is no longer active at the bank), `charge_amount_limit_exceeded` (the amount exceeds the bank's per-charge limit), `bank_account_unavailable` (the bank account is closed, blocked, or could not be found), or `other`.
      - `metadata` object, required — Set of key-value pairs attached to the charge 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.
      - `recipient_account` PayoutsRecipientAccount — Bank account that receives the payout.
        - `holder_id` string, required — Tax identifier of the account holder, without dots or hyphens (RUT in Chile, RFC in Mexico).
        - `institution_id` string, required — Fintoc identifier of the institution that holds the account, such as `cl_banco_estado`.
        - `number` string, required — Account number. In Mexico, an 18-digit CLABE (Clave Bancaria Estandarizada).
        - `type` 'checking_account' | 'sight_account' | 'rut_account' | 'fsa_account', required — Account subtype. One of `checking_account`, `sight_account` (Chilean cuenta vista), `rut_account` (BancoEstado CuentaRUT), or `fsa_account` (Mexican FSA account).
      - `status` 'pending' | 'in_progress' | 'succeeded' | 'failed' | 'canceled', required — Current state of the charge. One of `pending` (not yet sent to the bank), `in_progress` (being processed by the bank), `succeeded`, `failed`, or `canceled`.
      - `subscription_id` string, required — Identifier of the subscription the charge belongs to.
    - RefundsRefund — A refund returns funds from a succeeded payment to the payer. Fintoc disburses refunds asynchronously, so a refund moves through `pending`, `in_progress`, and `succeeded`, or ends in `failed` or `canceled`. The `amount` and `currency` are denominated in the smallest unit of the refunded resource's currency.
      - `id` string, required — Unique identifier of the refund.
      - `object` 'refund', required — Type of the object. Always `refund`.
      - `amount` integer, 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_at` string, 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_code` string, 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.
      - `metadata` object, 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.
      - `recipient_account` object, nullable, required — Bank account that receives the refunded funds. `null` for refunds that are not disbursed by bank transfer (for example, card refunds).
        - `holder_id` string, required — Tax ID of the account holder, without dots or hyphen.
        - `holder_name` string, required — Name of the account holder.
        - `institution_id` string, required — Identifier of the institution where the account lives.
        - `number` string, required — Number of the account that receives the funds.
        - `type` 'checking_account' | 'sight_account', required — Type of the bank account. One of `checking_account` or `sight_account`.
      - `resource_id` string, 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_at` string, date-time, required — ISO 8601 timestamp of when the refund was last updated.

## Other responses

- `400` — Invalid request: the `resource_type` is missing or not one of the valid values.
- `401` — Invalid or missing API key.
- `404` — The payout does not exist or belongs to another organization.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/revisions/9dafa63688a3/schema)