Batch transfers

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

Go to Transfers → Batch Transfers in your Fintoc Dashboard and click Create.
Add a description, such as Pagos de octubre.
Download the country-specific template:
- 🇨🇱 Template Chile (CLP)
- 🇲🇽 Template Mexico (MXN)

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. 🇨🇱 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

Go to the Authorizations tab and select your batch to open its details.
Review the batch one last time.
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.

​Overview

​Key benefits

​How it works

​1. Create a batch transfer

​2. Fill out the template

​3. Upload your file

​4. Review and confirm

​5. Authorize the batch

​6. Track execution

​Batch statuses