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

# Transferencias por lotes

> Crea, autoriza y sigue hasta 5.000 transferencias salientes mexicanas desde un archivo en el Dashboard de Fintoc, con autenticación multifactor.

<Info>
  **Disponible solo en México, desde el Dashboard de Fintoc**

  Las transferencias por lotes no tienen API. En Chile, envía las transferencias de a una con [Enviar transferencias](/es/guides/business-accounts/outbound-transfers).
</Info>

## Resumen

Una transferencia por lotes te permite cargar, autorizar y ejecutar hasta 5000 transferencias desde un solo archivo. Úsala para nóminas, pagos a proveedores o desembolsos diarios a clientes.

### Beneficios clave

* Sube hasta **5000** transferencias en un archivo.
* Valida los datos automáticamente.
* Revisa los lotes antes de ejecutarlos.
* Requiere autenticación multifactor (MFA) antes de mover fondos.
* Da seguimiento al progreso y al resultado por lote o por transferencia individual.

***

## Cómo funciona

### 1. Crear una transferencia por lotes

1. Ve a **Transfers → Batch Transfers** en tu Dashboard de Fintoc y selecciona **Create**.
2. Asigna una **descripción**, por ejemplo `Pagos de octubre`.
3. Descarga la [plantilla de México (MXN)](https://docs.google.com/spreadsheets/d/12jCDW2K69eeZ-Rk-l6c4PQf7eVYKBID-9hBjIeoZPts/edit?usp=sharing).

### 2. Completar la plantilla

Cada fila representa una transferencia.

| Campo | Descripción | Requerido | Notas |
| - | - | - | - |
| `sender_account_number` | Número de cuenta desde donde se envía el dinero. | Requerido | |
| `counterparty_holder_id` | Registro Federal de Contribuyentes (RFC) del titular de la cuenta destino. | Opcional | |
| `counterparty_name` | Nombre del titular de la cuenta destino. | Opcional | |
| `counterparty_institution_id` | Institución de la cuenta de la contraparte. | Requerido si omites el número de cuenta bancaria mexicano estandarizado (CLABE) | Usa un código de 5 dígitos de [esta lista](https://www.banxico.org.mx/cep-scl/listaInstituciones.do). |
| `counterparty_account_number` | Número de la cuenta destino, como CLABE. | Requerido | |
| `amount` | Monto a transferir a la cuenta destino, en pesos mexicanos. | Requerido | Un decimal con `.`. |
| `comment` | Nota de texto libre adjunta a la transferencia. | Opcional | Máx. 40 caracteres. |
| `reference_id` | Referencia numérica. | Opcional | Máx. 7 dígitos. |
| `meta/...` | Columnas personalizadas de metadata. | Opcional | Se permiten hasta 50. Por ejemplo, la columna `meta/user_name` resulta en la columna personalizada `user_name`. |

### 3. Sube tu archivo

Al subir el archivo:

* Fintoc admite archivos **CSV**.
* Fintoc muestra mensajes de validación cuando encuentra errores.

Si ves un error, corrige tu archivo y vuelve a subirlo.
Fintoc muestra advertencias, como filas duplicadas, pero estas no bloquean la carga.

### 4. Revisar y confirmar

Antes de crear tu lote:

* Revisa el **total de transferencias** y el **monto total transferido**.
* Si es necesario, regresa y carga un nuevo archivo.

Después de confirmar, tu lote aparece en **Pending Authorizations**.

### 5. Autorizar el lote

1. Ve a la pestaña **Authorizations** y selecciona tu lote para abrir sus detalles.
2. Revisa el lote una última vez.
3. Elige una acción (no se puede deshacer):
   * ✅ **Authorize** (requiere MFA)
   * ❌ **Reject**

### 6. Ejecución y seguimiento

Fintoc procesa y da seguimiento a los lotes de la siguiente manera:

* El lote pasa a `in_progress` después de la autorización completa.
* Cada transferencia aparece individualmente en tu vista de **Transfers** como `pending` y luego `succeeded` o `failed`.
* Si algunas transferencias fallan, por ejemplo por saldo insuficiente, el lote termina como `partially_succeeded`.
* Los lotes expiran automáticamente después de dos semanas si no se autorizan.

## Probar la integración

Confirma que el lote llega a `succeeded` o `partially_succeeded` en tu vista de **Transfers**. Si alguna fila aparece como `failed`, revisa la razón del fallo antes de reintentarla.

## Estados del lote

| Estado | Descripción |
| - | - |
| `pending_authorization` | Creado, en espera de aprobación. |
| `in_progress` | Autorizado y en ejecución. |
| `succeeded` | Todas las transferencias se completaron con éxito. |
| `partially_succeeded` | Algunas transferencias tuvieron éxito y otras fallaron. |
| `failed` | Todas las transferencias fallaron. |
| `rejected` | Rechazado por un aprobador. |
| `expired` | No se autorizó dentro de 2 semanas. |

<br />