Disponible en México y ChilePuedes crear transferencias por lotes desde el Dashboard de Fintoc o con la API. Siempre las autorizas desde el Dashboard.En Chile, las organizaciones con una configuración heredada de Security pueden crear transferencias por lotes desde el Dashboard solo en modo
live.Resumen
Una transferencia por lotes te permite crear, autorizar y ejecutar hasta 5.000 transferencias desde un archivo en el Dashboard o con una solicitud de API. Ú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
- Ve a Transfers → Batch Transfers en tu Dashboard de Fintoc y selecciona Create.
- Asigna una descripción, por ejemplo
Pagos de octubre. - Descarga la plantilla de tu país:
2. Completar la plantilla
Cada fila representa una transferencia. Las columnas dependen del país de tu organización.México
Chile
Por ejemplo, un archivo de Chile con una transferencia se ve así:
Archivo de lote de Chile
3. Sube tu archivo
Al subir el archivo:- Fintoc admite archivos CSV.
- Fintoc revisa el formato y las columnas del archivo apenas lo subes.
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.
5. Autorizar el lote
- Ve a la pestaña Authorizations y selecciona tu lote para abrir sus detalles.
- Revisa el lote una última vez.
- 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_progressdespués de la autorización completa. - Cada transferencia aparece individualmente en tu vista de Transfers como
pendingy luegosucceededofailed. - 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.
Crea un lote con la API
En vez de subir un archivo, envía las transferencias de un lote en una sola solicitud a Create a transfer batch. La solicitud necesita una JSON Web Signature (JWS) en el headerFintoc-JWS-Signature, igual que una transferencia individual. Revisa Genera llaves JWS.
El lote parte en pending_authorization. Autorízalo desde el Dashboard como se describe en Autorizar el lote. Un lote que creas en modo test espera a que lo autorices desde el Dashboard en modo test.
Sigue el lote con estas herramientas:
- Webhooks: recibe un evento
transfer_batch.*cada vez que el lote cambia de estado. Revisa Tipos de eventos. - Estado del lote: llama a Get a transfer batch o List transfer batches.
- Transferencias del lote: llama a List transfers con el parámetro de consulta
transfer_batch_id.
Probar la integración
Confirma que el lote llega asucceeded o partially_succeeded en tu vista de Transfers. Si alguna fila aparece como failed, revisa la razón del fallo antes de reintentarla.