Saltar al contenido principal
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: Ciclo de vida de los estados de una Transfer y el evento de webhook que Fintoc emite en cada transición

Límites de transferencia

El monto máximo por Transfer depende del país:
Límite🇲🇽 México🇨🇱 Chile
Monto máximo por transferenciaSin límite$7.000.000 CLP

Rate limits

El rate limit por defecto es de 10 solicitudes de Transfer por segundo por cliente. 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.

Autorización de una transferencia

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