Saltar al contenido principal
Cuando solicitas un Refresh Intent, la actualización no es inmediata. Fintoc primero necesita ir al banco a buscar nuevos movimientos y el tiempo que esto puede tomar depende del banco y su estado de conexión, pero normalmente toma entre 1 y 3 minutos. Por lo tanto, no necesitas preguntar si la actualización terminó cada 5 segundos, debes crear un Webhook Endpoint, donde te notificaremos a través de un Event cuando el Refresh Intent se haya completado. Por cada cuenta en tu Link, te enviaremos un evento. Por ejemplo, si tu Link tiene tres cuentas, recibirás tres eventos, cada uno conteniendo el resultado de la actualización de cada cuenta. Ten en cuenta que los tres resultados podrían ser diferentes, y el Refresh Intent se marcará como exitoso solo si cada cuenta se actualiza exitosamente.

​
Si todo sale bien

Si la actualización va según lo planeado al actualizar una cuenta, te enviaremos un evento account.refresh_intent.succeeded que se ve así:
Dentro de la clave data, encontrarás el detalle sobre la actualización. En este caso, la cuenta con id: acc_00000000 se actualizó exitosamente, ya que su status es succeeded. El campo new_movements indica cuántos movimientos nuevos se encontraron durante la actualización. Si este número es distinto de cero, deberías consultar el endpoint List Movements para obtener los nuevos movimientos. Si ese número es cero, puedes asumir que ya tienes los últimos movimientos.
Bajo demanda, recurrente y el campo new_movementsEl campo new_movements se refiere a la cantidad de movimientos nuevos después de la actualización, y no desde la última vez que llamaste a la API, así que debes tener cuidado si tu cuenta también tiene actualizaciones recurrentes, ya que new_movements de una actualización puede no ser la cantidad de movimientos nuevos desde la última vez que solicitaste movimientos a Fintoc.

​
Si algo sale mal

Si la actualización falla, por ejemplo si la aplicación del banco está caída, te enviaremos un evento account.refresh_intent.failed.
Dentro de la clave data, encontrarás el detalle sobre la actualización. En este caso, la cuenta con id: acc_00000000 falló al actualizarse, ya que su status es failed. Si el public_error es retryable_error, puedes crear un nuevo Refresh Intent sin necesidad de esperar 5 minutos (el tiempo que debes esperar entre Refresh Intents). Si el public_error es support_required_error, por favor contacta a nuestro equipo de soporte.

​
Si las credenciales son inválidas

Si la actualización falla porque las credenciales son inválidas, te enviaremos un evento account.refresh_intent.rejected:
Dentro de la clave data, encontrarás el detalle sobre la actualización. En este caso, la cuenta con id: acc_00000000 falló al actualizarse debido a que el banco rechazó las credenciales como inválidas, ya que su status es rejected. Si este es el caso, puedes crear un nuevo Refresh Intent sin necesidad de esperar 5 minutos (el tiempo que debes esperar entre Refresh Intents). Pero ten cuidado. Hacer esto demasiadas veces muy rápido podría bloquear al usuario de su cuenta. Recomendamos esperar algún tiempo entre reintentos.
Credenciales inválidasA veces, los bancos dicen que un conjunto de credenciales es inválido cuando no lo es. Por eso te permitimos reintentar el Refresh Intent después de un estado rejected. Si las credenciales son de hecho inválidas, deberías re-conectar el Link a través del widget.