¿Cómo puedo realizar llamadas que requieren Multi-Factor Authentication o token dinámico?

Belvo admite la conexión a instituciones donde se necesita una 2FA u OTP (token dinámico o contraseña de un solo uso).

Cuando intentes acceder a información de la institución a través de una llamada POST a Belvo, puedes agregar el 2FA dentro de la llamada agregando un campo "token" dentro del body de la llamada.

Sin embargo, si no agregas el 2FA y es necesario para realizar la llamada, recibirás un error 428 que te solicitará el envío del token. El contenido del error será similar a este:

{
"detail": "Token Required",
"session": "2675b703b9d4451f8d4861a3eee54449",
"expiry": 9600,
"link": "30cb4806-6e00-48a4-91c9-ca55968576c8"
}

Una vez que tengas el valor del token, puedes usar el link y la session de la respuesta anterior para enviar una nueva solicitud PATCH para reanudar la llamada:

curl -X PATCH \
 https://api.belvo.co/api/links/ \
 -H 'Content-Type: application/json' \
 -H 'Host: api.belvo.co' \
 -H 'cache-control: no-cache' \
 -d '{
 "session": "2675b703b9d4451f8d4861a3eee54449",
 "token": "12345",
 "link": "30cb4806-6e00-48a4-91c9-ca55968576c8"
}' \
 -u [Secret Key ID]:[Secret Key PASSWORD]

Para obtener más detalles, puedes acceder a nuestra página de documentación sobre el MFA en nuestra guía de inicio rápido.