Saltar al contenido principal

Integración

Para integrar el Widget mediante un WebView en iOS y Android, debes usar el siguiente HTML:
La configuración del widget se debe pasar a través de un 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, debes pasar los siguientes query params para configurarlo, según el producto que quieras usar:
Text
También puedes incluir parámetros anidados en tu query utilizando el siguiente formato de query string:

Ejemplo de uso

Aquí tienes 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 lo que sucede 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 tu gusto (los enlaces podrían abrirse dentro de la misma aplicación, por ejemplo). Esto es importante porque, al usar el producto de Payment Initiation, después de finalizar el flujo de pago el usuario puede hacer clic en un enlace para descargar el comprobante de la transacción. Debes permitir que los enlaces se abran.

Redirecciones del WebView

Una vez integrado el WebView, 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 esa 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 el URL Scheme fintocwidgetAntes de integrar el widget de Fintoc con tu aplicación iOS, es importante agregar fintocwidget como un URL scheme permitido dentro del archivo Info.plist de la aplicación. Esto es necesario por razones de seguridad.