Skip to main content
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 data, la cuenta con id: acc_00000001 tiene status: failed. Si public_error es retryable_error, revisa la respuesta de la API antes de reintentar, porque aún puede aplicar un tiempo de espera. Si public_error es support_required_error, contacta a 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 data, la cuenta con id: acc_00000002 tiene status: rejected porque el banco rechazó sus credenciales. La API puede bloquear otra solicitud mientras Fintoc verifica las credenciales o durante un tiempo de espera. Revisa la respuesta de la API antes de reintentar. Los intentos repetidos pueden bloquear el acceso del titular a su cuenta bancaria.
Credenciales inválidasA veces, los bancos dicen que un conjunto de credenciales es inválido cuando no lo es. Por esta razón, Fintoc te permite reintentar el Refresh Intent después de un estado rejected. Si las credenciales son inválidas, reconecta el Link. Revisa Reconecta un Link.