Saltar al contenido principal

Integración

Para integrar el Widget usando un WebView en iOS y Android, debes usar el siguiente HTML:
La configuración del widget se debe pasar a través de una querystring en lugar de usar JavaScript del lado del cliente.
¿Usas React Native?¡Revisa nuestra librería de npm @fintoc/fintoc-react-native para integrar el WebView a tu aplicación rápidamente!

Cómo funciona

Al incluir el WebView de Fintoc en tu aplicación móvil, necesitas pasar los siguientes query params para configurarlo, dependiendo del producto que quieras usar:
Text

Objeto Username

Para rellenar previamente un username y cambiar los valores por defecto, puedes enviar un objeto con los siguientes atributos:
También puedes incluir parámetros anidados en tu query usando el siguiente formato de query string:
Librerías como qs pueden ayudarte a formatear automáticamente un objeto anidado.

Ejemplo de uso

Aquí hay algunos snippets para que empieces lo más rápido humanamente posible:
Fíjate que el ejemplo en Swift tiene un método webView. Este método define qué pasa cuando un usuario hace clic en un enlace dentro del WebView. En el ejemplo, el enlace se abre en Safari, pero puedes personalizar este comportamiento a voluntad (los enlaces podrían abrirse dentro de la misma aplicación, por ejemplo). Esto es importante porque, al usar el producto Payment Initiation, después de terminar el flujo de pago el usuario puede hacer clic en un enlace para descargar el comprobante de la transacción. Deberías permitir que los enlaces se abran.

Redirecciones del WebView

Una vez que el WebView esté integrado, puedes interactuar con sus eventos usando redirecciones.
onEvent (WebView)El evento onEvent para WebView está deshabilitado por defecto y se puede habilitar pasando el queryparam _on_event={any_value} como parámetro de https://webview.fintoc.com/widget.html (por ejemplo: https://webview.fintoc.com/widget.html?[...]&_on_event=true). Una vez habilitado, será posible recibir eventos onEvent. A partir del 1 de mayo de 2023, esta funcionalidad estará habilitada por defecto, por lo que es necesario manejar la redirección onEvent antes de esta fecha para evitar romper la integración con el Widget.
Para usar estos métodos en Android e iOS, puedes usar los siguientes snippets:
iOS - agregar fintocwidget como URL SchemeAntes de integrar el widget de Fintoc con tu app de iOS, es importante agregar fintocwidget como un URL scheme permitido dentro del archivo Info.plist de la app. Esto es requerido por razones de seguridad.