> ## 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. # List payout 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. **`v1`** ยท Base URL `https://api.fintoc.com/v1` ## OpenAPI ````yaml reference/fintoc-api.json GET /payouts/{id}/resources openapi: 3.1.0 info: title: fintoc-api version: v2026-02-01 servers: - url: https://api.fintoc.com/v1 security: [] paths: /payouts/{id}/resources: get: tags: - Payouts summary: List payout resources description: >- 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. operationId: payouts-resources-list parameters: - name: id in: path description: Unique identifier of the payout whose resources to list. required: true schema: type: string - name: resource_type in: query required: true schema: type: string enum: - charge - payment_intent - refund - refund_adjustment description: >- Type of resources to list. One of `payment_intent` (payment intents the payout disburses), `charge` (charges the payout disburses), `refund` (refunds discounted from the payout amount), or `refund_adjustment` (refund amounts the payout credits back after a failed refund). - name: page in: query required: false schema: type: integer format: int32 description: Page number to retrieve. Starts at `1`. - name: per_page in: query required: false schema: type: integer format: int32 description: >- Number of resources per page. Defaults to `30`. The maximum is `300`. responses: '200': description: >- 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. headers: Link: schema: type: string X-Total-Count: schema: type: integer content: application/json: examples: payment_intents_list: value: - id: pi_BO381oEATXonG6bj object: payment_intent amount: 550000 created_at: '2026-03-04T11:32:45.466Z' currency: CLP mode: live recipient_account: holder_id: '111111111' institution_id: cl_banco_estado number: '987654321' type: checking_account reference_id: null sender_account: holder_id: '111111111' institution_id: cl_banco_de_chile number: '123456789' type: checking_account status: succeeded transaction_date: '2026-03-04T11:33:15.474Z' widget_token: null summary: Payment intents the payout disburses refunds_list: value: - id: ref_BO381oEATXonG6bj object: refund amount: 12000 created_at: '2026-03-04T11:32:45Z' currency: CLP failure_code: null metadata: {} mode: live resource_id: pi_BO381oEATXonG6bj resource_type: payment_intent status: succeeded updated_at: '2026-03-04T11:35:45Z' summary: Refunds discounted from the payout schema: type: array items: anyOf: - $ref: '#/components/schemas/payment_intent' - $ref: '#/components/schemas/subscriptions_charge' - $ref: '#/components/schemas/refunds_refund' '400': description: >- Invalid request: the `resource_type` is missing or not one of the valid values. content: application/json: examples: invalid_resource_type: value: error: type: invalid_request_error code: invalid_enum param: resource_type message: >- Invalid resource_type: invalid. Must be one of 'charge', 'payment_intent', 'refund' or 'refund_adjustment'. doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' '404': description: The payout does not exist or belongs to another organization. content: application/json: examples: payout_not_found: value: error: type: invalid_request_error code: missing_resource param: id message: 'No such payouts/payout: po_BO381oEATXonG6bj' doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: payment_intent: type: object properties: id: type: string description: Unique identifier of the payment intent. example: pi_BO381oEATXonG6bj object: const: payment_intent description: Type of the object. Always `payment_intent`. amount: type: integer description: >- 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). example: 100000 business_profile: type: - object - 'null' description: >- Profile of the business that collects the payment, when provided. `null` otherwise. properties: category: type: string description: Category of the business. name: type: string description: Name of the business. tax_id: type: string description: Tax identifier of the business. created_at: type: string format: date-time description: ISO 8601 timestamp of when the payment intent was created. example: '2021-10-15T15:23:11.474Z' currency: type: string enum: - CLP - MXN description: >- Three-letter ISO 4217 currency code of the payment intent. One of `CLP` or `MXN`. example: CLP customer: type: - object - 'null' description: >- Customer associated with the payment intent, when it was created from a checkout session with a customer. `null` otherwise. properties: id: type: string description: Unique identifier of the customer. object: const: customer description: Type of the object. Always `customer`. address: type: - object - 'null' description: Address of the customer. `null` when not provided. properties: city: type: string description: City of the address. country: type: string description: Country of the address. line1: type: string description: First line of the address. line2: type: string description: Second line of the address. postal_code: type: string description: Postal code of the address. state: type: string description: State of the address. created_at: type: string format: date-time description: ISO 8601 timestamp of when the customer was created. email: type: - string - 'null' description: Email address of the customer. metadata: type: object description: Set of key-value pairs attached to the customer. mode: type: string description: Mode of the customer. One of `live` or `test`. name: type: - string - 'null' description: Name of the customer. phone: type: - string - 'null' description: Phone number of the customer. tax_id: type: - object - 'null' description: Tax identifier of the customer. `null` when not provided. properties: type: type: string description: Type of the tax identifier, for example `cl_rut`. value: type: string description: Value of the tax identifier. customer_email: type: - string - 'null' description: >- Email address of the customer that receives payment notifications. `null` when not provided. example: jon.snow@example.com error_reason: type: - string - 'null' description: >- Reason why the payment failed, was rejected, or expired. `null` while the payment is in progress and when it succeeds. example: insufficient_funds expires_at: type: - string - 'null' format: date-time description: >- ISO 8601 timestamp of when the payment expires and can no longer be paid. Only set for cash payments; `null` otherwise. metadata: type: object description: Set of key-value pairs attached to the payment intent. example: order_id: '9182' mode: $ref: '#/components/schemas/mode' next_action: type: - object - 'null' description: >- Action the customer must complete to continue the payment, as reported by the widget. `null` when no action is pending. payment_method: type: - string - 'null' description: >- Identifier of the payment method used to pay, when the payment intent comes from a checkout session or a subscription. `null` otherwise. example: pm_1x7vKQ8oEATXonG6 payment_type: type: string description: Payment type used to pay, such as `bank_transfer` or `cash`. example: bank_transfer payment_type_options: type: object description: >- 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. properties: card: type: object description: Details of the card payment. Present only for card payments. properties: authenticated_with_3ds: type: boolean description: >- If `true`, the cardholder completed 3-D Secure authentication for this payment. example: true bank: type: - string - 'null' description: >- Name of the bank that issued the card. `null` when the issuing bank is unknown. example: Banco de Chile brand: type: string description: Brand of the card. example: visa country: type: string description: >- Display name of the country where the card was issued, in English. example: Chile kind: type: string description: Kind of card. One of `credit`, `debit`, or `prepaid`. example: credit last_four_digits: type: - string - 'null' description: >- Last four digits of the card number. `null` when the digits are not available. example: '4242' wallet: type: - string - 'null' enum: - apple_pay - google_pay - null description: >- Digital wallet used for the card payment. One of `apple_pay` or `google_pay`. `null` for cards entered manually. example: apple_pay example: {} recipient_account: type: - object - 'null' description: Bank account that receives the payment. `null` for cash payments. properties: holder_id: type: - string - 'null' description: >- Tax identifier of the account holder (RUT in Chile, RFC in Mexico). example: '111111111' institution_id: type: - string - 'null' description: Identifier of the institution of the account. example: cl_banco_de_chile number: type: - string - 'null' description: Number of the account. In Mexico, the CLABE. example: '123456789' type: type: - string - 'null' description: >- Type of the account, such as `checking_account` or `sight_account`. example: checking_account required: - holder_id - number - type - institution_id reference_id: type: - string - 'null' description: >- Identifier of the transfer assigned by the institution. `null` until the transfer is executed. example: '90123712' sender_account: type: - object - 'null' description: >- Bank account the customer pays from. `null` until Fintoc identifies the sender. properties: holder_id: type: string description: >- Tax identifier of the account holder (RUT in Chile, RFC in Mexico). example: '111111111' institution_id: type: string description: Identifier of the institution of the account. example: cl_banco_estado number: type: string description: Number of the account. example: '123456789' type: type: string description: >- Type of the account, such as `checking_account` or `sight_account`. example: checking_account required: - holder_id - number - type - institution_id status: type: string enum: - created - failed - succeeded - rejected - in_progress - pending - expired description: >- 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). example: succeeded subscription: type: - string - 'null' description: >- Identifier of the subscription that originated the payment intent. `null` for one-off payments. example: sub_dJOd4hcZby9XK1Lm transaction_date: type: - string - 'null' format: date-time description: >- ISO 8601 timestamp of when the institution executed the transfer. `null` until the transfer is executed. example: '2021-10-15T15:24:15.474Z' widget_token: type: - string - 'null' description: >- Token used to initialize the Fintoc widget for this payment intent. Only returned when the payment intent is created; `null` in every other response. example: pi_BO381oEATXonG6bj_sec_aBcDeFgHiJkLmNoP required: - id - object - amount - created_at - currency - customer - customer_email - error_reason - expires_at - metadata - mode - next_action - payment_method - payment_type - payment_type_options - recipient_account - reference_id - sender_account - status - subscription - transaction_date - widget_token subscriptions_charge: type: object description: >- 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`. properties: id: type: string description: Unique identifier of the charge. example: ch_o9YDuRzUez2GqV4x object: const: charge description: Type of the object. Always `charge`. amount: type: integer description: >- A positive integer in the smallest unit of `currency` (for example, `1000` for `$1000 CLP`, since CLP has no minor unit). example: 5000 created_at: type: string format: date-time description: ISO 8601 timestamp of when the charge was created. example: '2021-05-17T17:04:10.284Z' currency: type: string description: >- Three-letter ISO 4217 currency code. `CLP` is the only supported currency. example: CLP failure_code: type: - string - 'null' enum: - insufficient_funds - subscription_inactive - charge_amount_limit_exceeded - bank_account_unavailable - other - null description: >- 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`. example: insufficient_funds metadata: type: object description: Set of key-value pairs attached to the charge when it was created. example: order_id: '9182' mode: $ref: '#/components/schemas/mode' recipient_account: anyOf: - $ref: '#/components/schemas/payouts_recipient_account' - type: 'null' description: >- Bank account that receives the funds of the charge. Only present when the charge has a recipient account attached. status: type: string enum: - pending - in_progress - succeeded - failed - canceled description: >- 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`. example: succeeded subscription_id: type: string description: Identifier of the subscription the charge belongs to. example: sub_nMNejK7BT8oGbvO4 required: - id - object - amount - created_at - currency - failure_code - metadata - mode - status - subscription_id refunds_refund: type: object description: >- 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. properties: id: type: string example: ref_8XzNbCv1LqKjWp4R description: Unique identifier of the refund. object: const: refund description: Type of the object. Always `refund`. amount: type: integer example: 5000 description: >- 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: type: string format: date-time example: '2026-03-04T17:04:10Z' description: ISO 8601 timestamp of when the refund was created. currency: type: string enum: - CLP - MXN example: CLP description: >- Three-letter ISO 4217 currency code. Always matches the currency of the refunded resource. failure_code: type: - string - 'null' description: >- 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: type: object example: order_id: '9182' description: Set of key-value pairs attached to the refund when it was created. mode: $ref: '#/components/schemas/mode' recipient_account: type: - object - 'null' description: >- Bank account that receives the refunded funds. `null` for refunds that are not disbursed by bank transfer (for example, card refunds). properties: holder_id: type: string example: '111111111' description: Tax ID of the account holder, without dots or hyphen. holder_name: type: string example: Jane Doe description: Name of the account holder. institution_id: type: string example: cl_banco_de_chile description: Identifier of the institution where the account lives. number: type: string example: '123456789' description: Number of the account that receives the funds. type: type: string enum: - checking_account - sight_account example: checking_account description: >- Type of the bank account. One of `checking_account` or `sight_account`. required: - holder_id - holder_name - institution_id - number - type resource_id: type: string example: pi_jsperFI9bnyM2RTo description: ID of the refunded resource. resource_type: type: string example: payment_intent enum: - payment_intent description: Type of the refunded resource. Always `payment_intent`. status: type: string enum: - pending - in_progress - succeeded - failed - canceled example: succeeded description: >- 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: type: string format: date-time example: '2026-03-04T17:04:10Z' description: ISO 8601 timestamp of when the refund was last updated. required: - id - object - amount - created_at - currency - failure_code - metadata - mode - recipient_account - resource_id - resource_type - status - updated_at error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_api_key`. Not returned by every error. example: invalid_api_key doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Invalid API Key: invalid-*oken' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. `null` when the error cannot be tied to a single parameter, and not returned by every error. example: amount type: type: string description: >- Category of the error, for example `invalid_request_error`, `authentication_error`, or `api_error`. example: invalid_request_error required: - type - message mode: type: string enum: - test - live description: >- Mode of the object. `live` objects use real institution data, `test` objects use fake data for integration testing. example: live payouts_recipient_account: type: object description: Bank account that receives the payout. properties: holder_id: type: string description: >- Tax identifier of the account holder, without dots or hyphens (RUT in Chile, RFC in Mexico). example: '111111111' institution_id: type: string description: >- Fintoc identifier of the institution that holds the account, such as `cl_banco_estado`. example: cl_banco_estado number: type: string description: >- Account number. In Mexico, an 18-digit CLABE (Clave Bancaria Estandarizada). example: '987654321' type: type: string enum: - checking_account - sight_account - rut_account - fsa_account description: >- Account subtype. One of `checking_account`, `sight_account` (Chilean cuenta vista), `rut_account` (BancoEstado CuentaRUT), or `fsa_account` (Mexican FSA account). example: checking_account required: - holder_id - institution_id - number - type securitySchemes: api_key: type: apiKey name: Authorization in: header ````