Flujo App2App de Hosted Widget (OFDA)

Con nuestro flujo App2App, puedes ofrecer a tus clientes una experiencia de aplicación más nativa utilizando el Hosted Widget de Belvo, mejorando su experiencia de usuario y reduciendo la fricción. En esta página, te guiaremos a través del nuevo flujo y proporcionaremos pautas sobre cómo implementarlo.

Flujo de usuario

Con el flujo App2App, la diferencia clave para el usuario es que después de que otorgan su consentimiento para compartir datos:

Son redirigidos a un navegador seguro para completar la solicitud.
Son redirigidos directamente a tu aplicación.
El widget de Belvo se abre en una webview dentro de tu aplicación.

¿En qué se diferencia del flujo habitual?

En el flujo habitual, cuando implementas el Hosted Widget usando deep links, el usuario completa todo el proceso de conexión en el navegador y luego se le solicita ser redirigido a tu aplicación, lo que genera fricción y una experiencia de usuario subóptima. Con este nuevo flujo, el usuario es transferido sin problemas a través de las diferentes redirecciones.

Implementación

Para usar el flujo App2App, necesitarás hacer los siguientes cambios en tu implementación actual:

Crear un enlace a tu aplicación.
Usar el enlace al generar el token de acceso.
Abrir el Webview Widget al ser redirigido a tu aplicación.

1. Enlace a tu aplicación

Antes de configurar la experiencia de la aplicación nativa, necesitas preparar un enlace universal (iOS) o un enlace de aplicación (Android). Este enlace se utiliza para redirigir a tu usuario de vuelta a tu aplicación después de que hayan otorgado su consentimiento en su institución.

¿Por qué no usar un enlace profundo?

Al usar un enlace profundo a tu aplicación, los usuarios reciben un mensaje emergente que deben confirmar antes de ser redirigidos a tu aplicación, lo que puede llevar a una mala experiencia de usuario y fricción. Al usar el application_link, los usuarios son redirigidos automáticamente a tu aplicación sin necesidad de confirmar la redirección.

2. Generando tu `access_token`

Al generar tu access_token, necesitas proporcionar los siguientes parámetros en el objeto callback_urls:

application_link : El enlace a tu aplicación al que los usuarios serán redirigidos después de otorgar consentimiento en su institución.
success: La URL a la que los usuarios son redirigidos cuando han completado con éxito el flujo del widget.
exit: La URL a la que los usuarios son redirigidos cuando salen del widget antes de completar el flujo.
event: La URL a la que los usuarios son redirigidos cuando ocurre un error.

App2App Flow Callback URLs

{
  "callback_urls": {
    "application_link": "https://your.company_name.br/belvo-widget",
    "success": "https://your.company_name.br/success",
    "exit": "https://your.company_name.br/exit",
    "event": "https://your.company_name.br/error"
  }
}

Para obtener instrucciones completas sobre cómo generar el access_token, por favor consulta nuestra guía de Hosted Widget (OFDA) dedicada.

3. Abrir Webview en redirección

Una vez que los usuarios otorgan consentimiento en su institución, son redirigidos a su aplicación usando el application_link, junto con una cadena de consulta que necesitarás usar para abrir el widget de Belvo como un webview dentro de tu aplicación.

Ejemplo de Redirección

https://mobile.tu-nombre-app.br/belvo-widget/ ## Tu application_link
	?access_token={someAccessToken}&consent_id={someConsentId}&locale=pt... ## Cadena de consulta con detalles para abrir el widget de Belvo

Tan pronto como los usuarios son redirigidos a tu aplicación, necesitas abrir un webview dentro de tu aplicación y lanzar el widget de Belvo:

Ejemplo de Apertura de Widget en Webview

https://widget.belvo.io/ ## La URL del Belvo Hosted Widget
	?access_token={someAccessToken}&consent_id={someConsentId}&locale=pt... ## La cadena de consulta que recibiste

✅ ¡Hecho! Con estos pequeños ajustes en tu implementación, los usuarios se moverán sin problemas de tu aplicación al widget, otorgarán su consentimiento y luego regresarán al widget dentro de tu aplicación.