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

# Batch transfers

> Load, authorize, and execute multiple transfers at once.

<Info>
  Batch transfers are available only in the Fintoc Dashboard.
</Info>

## Overview

This page explains how to create, authorize, and track up to 5,000 transfers from one file in the Fintoc Dashboard. Use batch transfers for payroll, supplier payouts, or daily client disbursements.

### Key benefits

Batch transfers provide these controls:

* Upload up to **5,000** transfers in one file.
* Validate data automatically.
* Review batches before executing them.
* Require multifactor authentication before funds move.
* Track the progress and outcome of each batch or transfer.

***

## How it works

### 1. Create a batch transfer

1. Go to **Transfers → Batch Transfers** in your Fintoc Dashboard and select **Create**.
2. Assign a **description**, for example `Pagos de octubre`.
3. Download the country-specific template:
   * 🇨🇱 [Template Chile (CLP)](https://docs.google.com/spreadsheets/d/1Ngcl07HLR2LmQ97SERhL6qn4LddwGe1rbBE5oQpGGFA/edit?usp=sharing)
   * 🇲🇽 [Template Mexico (MXN)](https://docs.google.com/spreadsheets/d/12jCDW2K69eeZ-Rk-l6c4PQf7eVYKBID-9hBjIeoZPts/edit?usp=sharing)

### 2. Fill out the template

Use these fields for each transfer row:

| Field                         | Description                                                                | 🇨🇱 Required | 🇲🇽 Required | Notes                                                                                                                                                                                                                                                                                          |
| ----------------------------- | -------------------------------------------------------------------------- | ------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sender_account_number`       | Account number that sends the money.                                       | ✅             | ✅             |                                                                                                                                                                                                                                                                                                |
| `counterparty_holder_id`      | Destination account holder's Chilean tax ID (RUT) or Mexican tax ID (RFC). | ✅             | ❌             |                                                                                                                                                                                                                                                                                                |
| `counterparty_name`           | Destination account holder's name.                                         | ❌             | ❌             |                                                                                                                                                                                                                                                                                                |
| `counterparty_institution_id` | Institution that holds the destination account.                            | ✅             | ❌ / ✅         | 🇲🇽 Required if you do not provide a standardized Mexican bank account number (CLABE). Use a 5-digit code from [this list](https://www.banxico.org.mx/cep-scl/listaInstituciones.do).<br />🇨🇱 Use a code such as `cl_banco_bbva` from [this list](/api/fintoc-api/chile-institution-codes). |
| `counterparty_account_number` | Destination account number.                                                | ✅             | ✅             | CLABE for Mexico or account number for Chile.                                                                                                                                                                                                                                                  |
| `amount`                      | Amount sent to the destination account.                                    | ✅             | ✅             | CLP as an integer or MXN as a decimal with `.`.                                                                                                                                                                                                                                                |
| `comment`                     | Free-text note attached to the transfer.                                   | ❌             | ❌             | Up to 40 characters.                                                                                                                                                                                                                                                                           |
| `reference_id`                | Numeric reference.                                                         | ❌             | ❌             | Up to 7 digits.                                                                                                                                                                                                                                                                                |
| `meta/...`                    | Custom metadata columns.                                                   | ❌             | ❌             | You can add up to 50 metadata columns. For example, `meta/user_name` creates the custom column `user_name`.                                                                                                                                                                                    |

<Warning>
  In Chile, Fintoc splits any row with an amount over 7,000,000 CLP into multiple independent transfers.
</Warning>

### 3. Upload your file

When you upload the file:

* Fintoc supports **CSV** files.
* Fintoc shows validation messages when it finds errors.

If you see an error, correct your file and upload it again.
Warnings, such as duplicate rows, do not block the upload.

### 4. Review and confirm

Before creating your batch:

* Review the **total number of transfers** and **total transfer amount**.
* If needed, go back and upload a new file.

After you confirm the batch, it appears under **Pending Authorizations**.

### 5. Authorize the batch

1. Go to the **Authorizations** tab and select your batch to open its details.
2. Review the batch one last time.
3. Choose one of these irreversible actions:
   * ✅ **Authorize** (requires multifactor authentication)
   * ❌ **Reject**

### 6. Execution and tracking

Fintoc processes and tracks batches as follows:

* The batch moves to `in_progress` after full authorization.
* Each transfer appears individually in your **Transfers** view as `pending`, then `succeeded` or `failed`.
* If some transfers fail, for example because of insufficient balance, the batch ends as `partially_succeeded`.
* Batches expire automatically after two weeks if they remain unauthorized.

## Test the integration

Confirm that the batch reaches `succeeded` or `partially_succeeded`. If any transfers appear as `failed` in your **Transfers** view, check the failure reason before retrying the transfers.

## Batch statuses

A batch moves through these statuses:

| Status                  | Description                            |
| ----------------------- | -------------------------------------- |
| `pending_authorization` | Created, awaiting approval.            |
| `in_progress`           | Authorized and executing.              |
| `succeeded`             | All transfers completed successfully.  |
| `partially_succeeded`   | Some transfers succeeded, some failed. |
| `failed`                | All transfers failed.                  |
| `rejected`              | Rejected by an approver.               |
| `expired`               | Not authorized within two weeks.       |

<br />