> ## 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 via Dashboard only**

## Overview

Batch Transfers are designed for teams who need to make **repetitive or high-volume transfers** efficiently while keeping full visibility and control. This feature is ideal for payrolls, supplier payouts, or daily client disbursements.

### Key benefits

* Upload up to **5000** transfers in one file.
* Validate data automatically.
* Review batches before executing them.
* Require MFA authorization before funds move.
* Track progress and outcomes per batch or per individual transfer.

***

## How It Works

### 1. Create a Batch Transfer

1. Go to **Transfers → Batch Transfers** in your Fintoc Dashboard and click **“Create”**.
2. Assign a **description**, e.g. `Pagos de octubre`.
3. Download the country-specific template:
   * 🇨🇱 [Template Chile (CLP)](https://docs.google.com/spreadsheets/d/1Ngcl07HLR2LmQ97SERhL6qn4LddwGe1rbBE5oQpGGFA/edit?usp=sharing)
   * 🇲🇽 [Template México (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 | Notes                                                                                                                                                                         |
| ----------------------------- | ------------------------------------------------- | ------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sender_account_number`       | Account number from which the money will be sent. | ✅             | ✅            |                                                                                                                                                                               |
| `counterparty_holder_id`      | Destination account holder 🇨🇱 RUT or 🇲🇽 RFC.  | ✅             | :x:          |                                                                                                                                                                               |
| `counterparty_name`           | Destination account holder name                   | ❌             | ❌            |                                                                                                                                                                               |
| `counterparty_institution_id` | The counterparty account institution.             | ✅             | ❌ / ✅        | 🇲🇽 Required if not CLABE. A 5 digit code from [this list](https://www.banxico.org.mx/cep-scl/listaInstituciones.do).<br />🇨🇱 A code like `cl_banco_bbva` from this list . |
| `counterparty_account_number` | Destination account number.                       | ✅             | ✅            | CLABE (MX) or account number (CL)                                                                                                                                             |
| `amount`                      | Transfer amount                                   | ✅             | ✅            | CLP (integer) or MXN (decimal with `.`)                                                                                                                                       |
| `comment`                     | Description                                       | ❌             | ❌            | Optional. Max 40 characters                                                                                                                                                   |
| `reference_id`                | Numeric reference                                 | ⛔             | ❌            | Optional. Max 7 digits                                                                                                                                                        |
| `meta/...`                    | Custom metadata columns.                          | ❌             | ❌            | Up to 50 allowed. For example: column `meta/user_name` will result in the custom column `user_name`                                                                           |

> ⚠️ In **Chile**, Fintoc will automatically split transfer rows with an amount over 7,000,000 CLP into multiple transfers
>
> These transactions will act as new independent transfers.

### 3. Upload Your File

* Supported formats: **CSV**
* You’ll see validation messages if errors are found

If you see an error, correct your file and re-upload.
Warnings (e.g. duplicated rows) will be shown but won’t block 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 confirming, your batch will appear 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 (cannot be undone):
   * ✅ **Authorize** (requires MFA)
   * ❌ **Reject**

### 6. Execution and Tracking

Once fully authorized:

* The batch moves to **`in_progress`**.
* Each transfer appears individually in your **Transfers** view as `pending`, then `succeeded` or `failed`.
* If some transfers fail (e.g. insufficient balance), the batch will end as **`partially_succeeded`**.
* Batches **expire automatically after 2 weeks** if not authorized.

## Batch 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 2 weeks.         |

<br />