Transfer

Una Transfer es un único movimiento de dinero, entrante o saliente. Las transferencias entrantes llegan a un Account Number; las transferencias salientes debitan una Account. Esta página explica el modelo de datos de Transfer: la Counterparty, los estados, los límites, las devoluciones y la autorización. Para la referencia campo por campo, consulta el objeto Transfer.

​

Counterparty de la transferencia

Cada Transfer incluye un objeto Counterparty anidado que representa a la otra parte de la transferencia: ya sea el remitente o el destinatario, según la dirección. El objeto Counterparty incluye información como:

• Nombre de la contraparte (por ejemplo, un cliente, proveedor o socio).
• Datos de la cuenta bancaria, como el número de cuenta y el código del banco.

Puedes pensar en la Counterparty como el “quién” de la transferencia:

• En las transferencias entrantes, la Counterparty es el remitente, la entidad que inició la transferencia hacia tu Account Number.
• En las transferencias salientes, la Counterparty es el destinatario, la entidad que recibe fondos desde tu Account.

Esta estructura te da una forma consistente de visualizar y conciliar cada transferencia, sin importar la contraparte.

​

Estados de transferencia y notificaciones por webhook

Una Transfer pasa por estos estados, y Fintoc emite un webhook por cada transición: Las transferencias salientes chilenas también pueden llegar a partially_succeeded cuando solo algunas partes de una transferencia sobre $7.000.000 CLP se liquidan, o a reversed después de que una transferencia liquidada se reversa. Fintoc emite transfer.outbound.partially_succeeded y transfer.outbound.reversed para estas transiciones. Una Transfer reporta uno de estos estados: Las transferencias salientes chilenas pueden reportar partially_succeeded. Todas las transferencias chilenas pueden reportar reverse_pending y reversed. Las mexicanas no reportan ninguno de estos estados.

​

Estados finales

failed, rejected, partially_succeeded, returned y reversed son estados finales. Una transferencia succeeded todavía puede pasar a return_pending y returned, o en Chile a reverse_pending y reversed. Una transferencia llega a rejected o reject_failed solo desde pending, así que una transferencia succeeded nunca pasa a rejected. Cuando una transferencia saliente chilena falla, Fintoc abona el amount completo de vuelta a tu saldo disponible, y el destinatario no recibe los fondos. Consulta los motivos de falla de transferencias chilenas. Las transferencias salientes nunca reportan rejected, ni en Chile ni en México. Un rechazo de la institución de la contraparte o del Banco de México mueve la transferencia saliente a failed, y Fintoc envía transfer.outbound.failed. Para los rechazos en México, consulta las causas de rechazo SPEI. Si una transferencia reporta reject_failed, contacta al soporte de Fintoc con el id de la transferencia antes de realizar cualquier otra acción sobre ella.

​

Límites de transferencia

La API de Transfer no fija un monto máximo en México ni en Chile. En Chile, algunos bancos limitan las transferencias entrantes a $7.000.000 CLP. Fintoc divide una transferencia saliente sobre $7.000.000 CLP en partes de hasta $7.000.000 CLP y reporta el resultado en el único Transfer que creaste. Fintoc envía las partes una tras otra, así que una transferencia dividida queda en pending más tiempo que una transferencia simple. Las transferencias entre cuentas de Fintoc no se dividen. Consulta Transferencias grandes en Chile.

​

Rate limits

El rate limit por defecto es de 10 solicitudes de Transfer por segundo por organización. Para solicitar un límite mayor, contacta al soporte de Fintoc.

​

Devoluciones de transferencias

​

🇲🇽 México

En México, puedes solicitar la devolución de una Transfer entrante si no la reconoces o no cumple los criterios de aceptación de tu negocio. Cuando Fintoc devuelve la Transfer, su estado cambia a returned. Fintoc descuenta el monto del saldo de tu cuenta.

​

🇨🇱 Chile

En Chile, puedes solicitar la devolución de una Transfer entrante en estado succeeded. Si la Transfer viene de otro banco, espera 90 segundos después de que llegue a succeeded antes de solicitar la devolución. Cuando Fintoc devuelve la Transfer, su estado cambia a returned. Fintoc descuenta el monto del saldo de tu cuenta. Consulta Devolver una transferencia.

​

Autorización de una transferencia

Las transferencias manuales del dashboard usan permisos de transferencias y porcentajes de autorización. Este flujo de aprobaciones no aplica a las transferencias creadas por API. Para transferencias por API, sigue Envía transferencias.

​

Autoriza transferencias manuales en el dashboard

Cuando creas una transferencia manual, tu permiso y porcentaje de autorización determinan qué ocurre:

• Autorizar con 100%: Tu autorización basta para crear la transferencia de inmediato. No necesitas la aprobación de otra persona.
• Autorizar con menos de 100%: Tu aprobación aporta tu porcentaje asignado. La solicitud queda pendiente de autorización hasta que otra persona aprueba y las aprobaciones suman el 100%.
• Solo Administrar: Creas una solicitud sin aportar un porcentaje de aprobación. Una o más personas con permiso para Autorizar deben aprobar hasta que las aprobaciones sumen el 100%.

Por ejemplo, dos aprobaciones de 50% cumplen el requisito. Una aprobación de 100% también lo cumple. Alcanzar el 100% crea la Transfer; no significa que los fondos se hayan liquidado. Sigue el resultado a través de los estados de transferencia.

​

Si no puedes autorizar una transferencia

El rol de Administrador y la autenticación por contraseña de un solo uso no bastan para autorizar transferencias. También necesitas el permiso Autorizar y un porcentaje de autorización asignado para la cuenta de origen. Si ves una solicitud en Business Accounts → Transferencias → Autorizaciones, pero no puedes aprobarla, revisa tus permisos de transferencias. El permiso Administrar por sí solo no permite aprobar, aunque otra persona haya creado la solicitud. Si tus permisos no corresponden a tus responsabilidades, contacta al soporte de Fintoc para revisar tu configuración de autorización. Consulta Roles de permisos para conocer los niveles de acceso.