Transfer

Una Transfer es un único movimiento de dinero, entrante o saliente. Las transferencias entrantes están asociadas 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.

​

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, el Centro de Compensación Automatizado (CCA) puede rechazar objetos Transfer entrantes o salientes. Cuando la CCA rechaza una Transfer, el estado de la Transfer cambia a returned y Fintoc restituye los fondos al saldo de tu cuenta. En Chile no puedes solicitar la devolución de una Transfer entrante.

​

Autorización de una transferencia

La API de Business Accounts admite un único autorizador. Cuando una persona de tu organización con permisos de autorización confirma una Transfer, Fintoc la paga de inmediato.