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

# Transfer

A `Transfer` represents one inbound or outbound money movement. Inbound transfers are associated with an Account Number; outbound transfers debit an `Account`. This page explains the `Transfer` data model: the `Counterparty`, statuses, limits, returns, and authorization. For the field-by-field reference, see [the `Transfer` object](/api/transfers-api/transfers/transfer-object).

## Transfer counterparty

Each `Transfer` includes a nested `Counterparty` object that represents the other party in the transfer: either the sender or the recipient, depending on the direction.

The `Counterparty` object includes these details:

* Counterparty name, such as a customer, supplier, or partner.
* Bank account details, such as the account number and bank code.

The counterparty's role depends on the transfer direction:

* For inbound transfers, the `Counterparty` is the entity that sent funds to your Account Number.
* For outbound transfers, the `Counterparty` is the entity that receives funds from your `Account`.

Use this structure to view and reconcile transfers consistently in either direction.

## Transfer statuses and webhook notifications

A `Transfer` moves through these statuses, and Fintoc emits a webhook for each transition:

<img src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/65876da117aa2b5d08bccd474ddcdde2386fd12e362f6d76e18362625c371874-image.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=26eef6ccbefe18a20b407ecd5d96c2a3" alt="Transfer status lifecycle and the webhook event Fintoc emits at each transition" width="2424" height="1521" data-path="images/65876da117aa2b5d08bccd474ddcdde2386fd12e362f6d76e18362625c371874-image.png" />

## Transfer limits

The maximum amount per `Transfer` depends on the country:

<table>
  <tr>
    <th>Limit</th>
    <th>🇲🇽 Mexico</th>
    <th>🇨🇱 Chile</th>
  </tr>

  <tr>
    <td>Maximum amount per transfer</td>
    <td>No limit</td>
    <td>\$7,000,000 CLP</td>
  </tr>
</table>

## Rate limits

The Transfers API accepts up to 10 requests per second per client by default. Contact Fintoc support to request a higher limit.

## Transfer returns

### 🇲🇽 Mexico

In Mexico, you can request the return of an inbound `Transfer` that you don't recognize or that doesn't meet your business's acceptance criteria. When Fintoc returns the `Transfer`, the status changes to `returned`. Fintoc deducts the transfer amount from your account balance.

### 🇨🇱 Chile

In Chile, the [Centro de Compensación Automatizado](https://www.cca.cl/) can reject inbound or outbound `Transfer` objects. When the Centro de Compensación Automatizado rejects a `Transfer`, the status changes to `returned`, and Fintoc restores the funds to your account balance.

## Authorizing a transfer

The Transfers API supports a single authorizer. When a person in your organization with permission to authorize transfers confirms a `Transfer`, Fintoc pays out the `Transfer` immediately.
