# Configuración de Inicio del Hosted Widget (OFDA)

Con el Hosted Connect Widget (OFDA) 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`)


## Define el tipo de enlace creado

Puedes definir el tipo de enlace que deseas que el widget cree. Puedes elegir crear enlaces `recurrent` o `single`. Por defecto, el `access_mode` está configurado como `recurrent`.

**Instrucciones**

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


```curl 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 single y recurrent.

## Agregar un identificador adicional para el enlace

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.).


Información personal identificable con `external_id`
Si utilizas cualquier información personal identificable en tu `external_id`, Belvo establecerá el `external_id` en `null`. Por lo tanto, no podrás filtrar tus enlaces por ese `external_id`.

**Instrucciones**

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


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

## Define qué países mostrar

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


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


```curl Country Code
https://widget.belvo.io/
    ?access_token={access_code}
    &country_codes=BR
```

## Selecciona una o más instituciones para mostrar

Puedes elegir iniciar el widget ya en la página de inicio de sesión para 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, solo agrégala a la clave `institution` (para una institución singular) o `institutions` (para múltiples instituciones).


```curl Institution Display
## Para mostrar solo una institución:
https://widget.belvo.io/
    ?access_token={access_code}
    &institution=ofbancodobrasil_br_retail

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

Si la combinación de `institutions`, `institution_types` y `locale` solo resulta en una institución disponible para el usuario, entonces el widget muestra directamente la página de inicio de sesión para esa institución

## Define qué tipos de instituciones mostrar

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 comerciales (como Bradesco Business)
- `retail` para bancos minoristas (como Santander Retail)


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


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

## Define qué instituciones mostrar basadas en los recursos de Belvo

Puedes elegir qué instituciones mostrar en el widget según 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 el IMSS).

El widget evalúa los recursos que proporcionas como una expresión `AND`. Por ejemplo, si agregas `ACCOUNTS` y `OWNERS` al parámetro `resources`, entonces el widget solo mostrará instituciones que soporten tanto `ACCOUNTS` **y** `OWNERS`.

**Instrucciones**
Para establecer qué instituciones mostrar en el widget basadas en los recursos soportados, simplemente agrega uno o más recursos a la clave `resources`.


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

## Define el idioma para el widget

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:

- `pt` para 🇧🇷Portugués Brasileño


**Instrucciones**
Para establecer el idioma del widget, simplemente agrega `pt` (solo letras minúsculas) a la clave `locale`.


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

## Desactivar el diálogo de salida

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`:


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

## Desactivar la encuesta de salida

De forma predeterminada, 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`:


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