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.

​

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

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.