Link cuando los necesites. Refresh On Demand tiene un costo adicional y debe estar habilitado para tu organización. Contacta a nuestro equipo de Sales o Customer Success para agregarlo a tu plan.
Solicita una actualización
En el Dashboard de Fintoc, entra a Links, abre el menú··· del Link y selecciona Actualizar ahora. El botón solicita los movimientos más recientes. Solo aparece si tu organización tiene acceso a esta acción y tu rol puede editar el Link.
También puedes crear un Refresh Intent mediante la API. Usa la API para solicitar una actualización histórica o abrir el Widget si el banco requiere autenticación multifactor. El botón del Dashboard no puede completar una actualización que requiere autenticación multifactor.
Restricciones de uso
- No puedes crear un Refresh Intent mientras haya otra actualización en curso para el mismo
Link. - La API puede rechazar la solicitud si las cuentas del
Linkestán al día según su intervalo de actualización. - Después de una actualización exitosa, la API puede rechazar otra solicitud si han pasado menos de cinco minutos desde la creación del Refresh Intent anterior. Una solicitud histórica también puede bloquearse si se creó otra actualización histórica en los últimos 60 minutos.
- Después de una actualización fallida, revisa la respuesta de la API antes de reintentar. Un fallo no garantiza que puedas reintentar de inmediato. Si el banco rechaza las credenciales, puede que necesites reconectar el
Link.
Uso recomendado
- Solicita una actualización cuando una persona o un proceso de negocio necesite datos recientes. Evita los procesos programados que actualizan todos los
Linkscada cierto intervalo. - Usa
only_lastpara actualizaciones habituales. Solicitahistoricalsolo cuando necesites movimientos anteriores. - Espera el resultado de la actualización antes de reintentar. Después de un fallo, usa backoff y respeta el tiempo de espera de la API. Si el banco rechaza las credenciales, reconecta el
Link.
Recibe el resultado de la actualización
La actualización no es inmediata, tanto si la solicitas desde el Dashboard como desde la API. Normalmente tarda entre uno y tres minutos, según el banco y el estado de su conexión. Fintoc no garantiza un tiempo máximo. Fintoc te avisa mediante webhooks cuando termina de actualizar cada cuenta delLink.
Configura tus webhooks y selecciona estos eventos:
account.refresh_intent.succeeded: La cuenta se actualizó. Ya puedes consultar sus movimientos.account.refresh_intent.failed: Hubo un problema al actualizar la cuenta.account.refresh_intent.rejected: El banco rechazó las credenciales de acceso.