Configuración de Inicio del Hosted Widget

Con el Widget de Belvo, puedes configurar qué enlaces crear y la información que deseas mostrar en el widget. Esto incluye:

• tipo de enlaces a crear (access_mode)
• identificador adicional para el enlace (external_id)
• qué países mostrar (country_codes)
• instituciones a mostrar (institutions)
• tipos de instituciones a mostrar (institution_types)
• idioma del widget (locale)
• deshabilitar el diálogo de salida (show_close_dialog)
• deshabilitar la encuesta de salida (show_abandon_survey)

Puedes definir el tipo de enlace que deseas que el widget cree. Por defecto, creamos enlaces recurrentes. Puedes elegir crear enlaces recurrent o single.

Instrucciones

Para establecer qué tipo de enlace crear, simplemente añade single o recurrent a la clave access_mode.

https://widget.belvo.io/?access_token={access_code}&access_mode=single

Lee más sobre nuestros diferentes tipos de enlaces aquí: diferencia entre enlace único y recurrente.

Puedes agregar un identificador adicional para asociarlo con el enlace en la base de datos de Belvo. Para más información, consulta nuestro artículo sobre la creación de enlaces.

El external_id que proporciones:

• debe ser un ID único para cada usuario en tu base de datos.
• debe tener al menos tres caracteres de longitud.
• solo puede estar compuesto por letras, números, guiones (-) y guiones bajos (_).
• no puede contener ninguna información personal identificable sobre el usuario (correo electrónico, nombre, número de teléfono, número de tarjeta de crédito, etc.).

Instrucciones

Para establecer qué tipo de enlace crear, simplemente agrega un ID único a la clave external_id.

https://widget.belvo.io/?access_token={access_code}&external_id=HJLSI-897809

Puedes definir de qué países los usuarios pueden seleccionar instituciones. Por defecto, el widget muestra todos los países compatibles. Los países compatibles son:

• BR para 🇧🇷 Brasil
• MX para 🇲🇽 México

Instrucciones
Para establecer qué país mostrar, simplemente agrega BR o MX (solo letras mayúsculas) a la clave country_codes.

https://widget.belvo.io/?access_token={access_code}&country_codes=MX

Puedes elegir iniciar el widget directamente en la página de inicio de sesión de una institución específica o mostrar solo instituciones seleccionadas. Por defecto, el widget muestra todas las instituciones compatibles.

Instrucciones
Para establecer una o más instituciones para mostrar en el widget, simplemente agrégala al key institutions.

## Para mostrar solo una institución:
https://widget.belvo.io/?access_token={access_code}&institutions=erebor_mx_retail

## Para mostrar más de una institución:
https://widget.belvo.io/?access_token={access_code}&institutions=erebor_mx_retail,gringotts_mx_retail

Puedes elegir qué tipos de instituciones mostrar en el widget. Por defecto, el widget muestra todos los tipos de instituciones compatibles.

Elige uno o más de los siguientes tipos de instituciones:

• business para bancos empresariales (como Bradesco Business)
• retail para bancos minoristas (como Santander Retail)
• fiscal para instituciones fiscales (como SAT)
• employment para instituciones de empleo (como IMSS).

Instrucciones
Para configurar qué instituciones mostrar en el widget, simplemente añade uno o más al key institution_types.

https://widget.belvo.io/?access_token={access_code}&institution_types=retail,business

Puedes elegir qué instituciones mostrar en el widget basándote en los recursos de la API de Belvo que la institución soporte.

Por ejemplo, si deseas mostrar solo instituciones que soporten el recurso de portafolios de inversión, necesitas usar este parámetro. Por defecto, el widget muestra todas las instituciones (excepto las instituciones de employment como IMSS).

Instrucciones
Para establecer qué instituciones mostrar en el widget basándose en los recursos soportados, simplemente añade uno o más recursos a la clave resources.

https://widget.belvo.io/?access_token={access_code}&resources=ACCOUNTS,OWNERS,TRANSACTIONS

Puedes elegir en qué idioma se debe mostrar el widget. Por defecto, el widget se muestra en español (ES).

Elige uno de los siguientes idiomas para el widget:

• en para 🇬🇧 Inglés
• es para 🇪🇸 Español
• pt para 🇧🇷 Portugués Brasileño

Instrucciones
Para establecer el idioma del widget, simplemente añade es, en o pt (solo letras minúsculas) a la clave locale.

https://widget.belvo.io/?access_token={access_code}&locale=pt

Por defecto, cuando el usuario intenta salir del widget, Belvo muestra un mensaje de "¿estás seguro de que deseas salir del proceso?". Sin embargo, puedes desactivar este mensaje.

Instrucciones
Para desactivar el mensaje de salida, simplemente añade false a la clave show_close_dialog:

https://widget.belvo.io/?access_token={access_code}&show_close_dialog=false

Por defecto, cuando el usuario sale del widget, Belvo muestra una encuesta preguntando por qué el usuario decidió no continuar con la conexión de su cuenta. Sin embargo, puedes desactivar esta encuesta.

Instrucciones
Para desactivar la encuesta de salida, simplemente añade false a la clave show_abandon_survey:

https://widget.belvo.io/?access_token={access_code}&show_abandon_survey=false