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

> **Available only in the Fintoc Dashboard.**

## Overview

This guide explains how to create and track up to 5,000 transfers from a single CSV file. Use batch transfers for payroll, supplier payouts, or client disbursements.

### Key benefits

Batch transfers let you:

* Upload up to **5,000** transfers in one file.
* Validate data automatically.
* Review batches before executing them.
* Require multi-factor authentication (MFA) before funds move.
* Track progress and outcomes for each batch and transfer.

***

## How it works

### 1. Create a batch transfer

1. Go to **Transfers → Batch Transfers** in your Fintoc Dashboard and click **Create**.
2. Add a description, such as `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

Each row represents one transfer.

| Field                         | Description                                                                     | 🇨🇱 Required | 🇲🇽 Required | Requirements                                                                                                                                                                                                                                                          |
| ----------------------------- | ------------------------------------------------------------------------------- | ------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sender_account_number`       | Source account number for the transfer.                                         | ✅             | ✅             |                                                                                                                                                                                                                                                                       |
| `counterparty_holder_id`      | Chilean tax ID (RUT) or Mexican tax ID (RFC) of the destination account holder. | ✅             | :x:           |                                                                                                                                                                                                                                                                       |
| `counterparty_name`           | Destination account holder name.                                                | ❌             | ❌             |                                                                                                                                                                                                                                                                       |
| `counterparty_institution_id` | Institution that holds the destination account.                                 | ✅             | ❌ / ✅         | 🇲🇽 Required when `counterparty_account_number` is not 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 an institution code such as `cl_banco_bbva`. |
| `counterparty_account_number` | Destination account number.                                                     | ✅             | ✅             | CLABE for Mexico or account number for Chile.                                                                                                                                                                                                                         |
| `amount`                      | Transfer amount.                                                                | ✅             | ✅             | Integer in CLP or decimal in MXN, using `.` as the decimal separator.                                                                                                                                                                                                 |
| `comment`                     | Transfer description.                                                           | ❌             | ❌             | Up to 40 characters.                                                                                                                                                                                                                                                  |
| `reference_id`                | Numeric reference.                                                              | ⛔             | ❌             | Up to 7 digits.                                                                                                                                                                                                                                                       |
| `meta/...`                    | Custom metadata columns.                                                        | ❌             | ❌             | Up to 50 columns. For example, `meta/user_name` creates the custom column `user_name`.                                                                                                                                                                                |

> ⚠️ In **Chile**, Fintoc automatically splits rows over 7,000,000 CLP into multiple transfers.
>
> Each resulting transfer is independent.

### 3. Upload your file

Upload the completed template:

* Save and upload the template as a **CSV** file.
* Review any validation messages from the dashboard.

If you see an error, correct the file and upload it again. The dashboard displays warnings, such as duplicate rows, but the warnings 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 an action. You cannot undo either action:
   * ✅ **Authorize** (requires MFA)
   * ❌ **Reject**

### 6. Track execution

Once fully authorized:

* The batch moves to `in_progress`.
* Each transfer appears in your **Transfers** view as `pending`, then `succeeded` or `failed`.
* If some transfers fail because of an insufficient balance, the batch ends as `partially_succeeded`.
* Batches expire automatically after 2 weeks if not authorized.

## Batch statuses

The following statuses describe the batch lifecycle:

| Status                  | Description                                             |
| ----------------------- | ------------------------------------------------------- |
| `pending_authorization` | The batch awaits approval.                              |
| `in_progress`           | Fintoc is executing the authorized batch.               |
| `succeeded`             | All transfers succeeded.                                |
| `partially_succeeded`   | Some transfers succeeded; others failed.                |
| `failed`                | All transfers failed.                                   |
| `rejected`              | An approver rejected the batch.                         |
| `expired`               | The batch did not receive authorization within 2 weeks. |

<br />