Puedes usar el hosted widget de Belvo para actualizar un link que requiere una nueva contraseña o un nuevo token MFA. Necesitarás actualizar un link si:

• La institución requiere un nuevo token MFA para iniciar sesión.
• El usuario ha cambiado la contraseña conectada con el Link.

El flujo general para actualizar un enlace con el widget es:

1. Recibes un error de enlace.

2. Solicitas dentro de tu aplicación que tu usuario actualice sus credenciales o proporcione un nuevo token de autenticación. Por ejemplo, mostrando un botón de Actualizar para que lo presionen.

3. Una vez que inician el proceso de actualización, realizas una llamada desde tu servidor para generar un access_token, proporcionando el link_id del usuario. Consulta el ejemplo de código a continuación.

curl -X POST \
  https://sandbox.belvo.com/api/token/ \
  -H 'Content-Type: application/json' \
  -H 'Host: sandbox.belvo.com' \
  -d '{
    "id": "SECRET_ID",
    "password": "SECRET_PASSWORD",
    "link_id": "LINK_ID",
    "scopes": "read_institutions,write_links,read_links"
  }'

4. Inicia el widget y el usuario actualiza su enlace
   Debido a que proporcionas el link_id, detectamos qué tipo de actualización de enlace necesita ser activada (token o credenciales) y guiamos al usuario a través del proceso. Una vez que proporcionan exitosamente sus credenciales o token de autenticación, establecemos el estado del enlace como valid.

✳️ ¡Hecho! Una vez que un enlace recurrente se actualiza con éxito, el estado del enlace es valid nuevamente y el link_id permanece igual. Recibirás una respuesta de callback de éxito en el widget.

Si el enlace actualizado con éxito es recurrente, automáticamente activamos una actualización del enlace. Si encontramos datos frescos, recibirás webhooks de actualización histórica.

❗️ ¿Qué sucede si hay un error al actualizar el enlace?

Seguirás recibiendo callbacks de éxito y error en el widget como de costumbre. El
estado del enlace no será valid nuevamente hasta que se haya actualizado con éxito.

¿Cómo sé si un enlace necesita ser actualizado?

Un enlace necesitará ser actualizado en los siguientes escenarios:

Escenario 1: recibes un error de la API
Al hacer una llamada POST a nuestra API, puedes recibir errores que significan que el enlace necesita ser actualizado:

Escenario 2: recibes un error de webhook para un enlace recurrente
Durante la actualización diaria de tus enlaces recurrentes, enviaremos un evento en caso de que uno de tus enlaces necesite ser actualizado para ser refrescado.

¿Cómo puedo saber qué enlaces necesitan ser actualizados?

Usando List all Links y verificando el estado del enlace, puedes ver qué enlaces necesitan ser actualizados por tus usuarios.
Si el estado del enlace es invalid o token_required, necesita ser actualizado.

Por ejemplo:

# enlaces inválidos
curl -u Secret-Key-ID:Secret-Key-PASSWORD  \
https://sandbox.belvo.com/api/links/?status=invalid

# enlaces que requieren token
curl -u Secret-Key-ID:Secret-Key-PASSWORD  \
https://sandbox.belvo.com/api/links/?status=token_required

curl -u [Secret Key ID]:[Secret Key PASSWORD]  \
https://sandbox.belvo.com/api/links/[LINK ID]/

curl -u [Secret Key ID]:[Secret Key PASSWORD]  \
https://sandbox.belvo.com/api/links/

¿Cómo puedo probar el widget en modo de actualización?

Utiliza la institución Heimdall en nuestro entorno sandbox. Después de que registres un enlace con la institución, cualquier llamada POST adicional hecha a la institución devolverá una respuesta 428 Token Required, donde el estado del enlace se cambiará a token_required.

Luego, todo lo que necesitas hacer es pasar el link_id cuando inicies el widget, y cuando proporciones con éxito las credenciales necesarias, el estado del enlace se actualizará a valid nuevamente.