Integración Web

Referencia para integrar el Widget en tu app o página web

Integración

Para integrarse con el Widget, solo se debe incluir el script de Fintoc en el html. El script de Fintoc debe estar en cada página en donde se quiera utilizar el widget.

<script src="https://js.fintoc.com/v1/" />

📘

window.onload

Recuerda que al importar un script de javascript, si tratas de utilizar funciones antes de que el browser pueda cargar el script por completo, saldrá un error. Puedes solucionar esto utilizando el evento nativo del browser window.onload.

Cómo funciona

Al incluir el script de Fintoc en tu aplicación tendrás acceso a la clase Fintoc que te permitirá crear conexiones con el banco desde tu aplicación.

const widget = Fintoc.create({
  holderType,
  product,
  publicKey,
  webhookUrl,
  onSuccess,
  onExit,
  onEvent,
})

Parametro

Tipo

Descripción

publicKey

string

El publicKey se utiliza para identificar tu aplicación o página web con Fintoc. Los links creados se asignarán a la organización o usuario al que le pertenece el publicKey.
Este token determinará si estás en el ambiente de prueba o en el ambiente de producción. El publicKey en el ambiente de prueba empieza con pk_test y el de producción con pk_live

holderType

string

El parametro holderType puede ser business o individual y determina el tipo de cuenta que se quiere conectar.

product

string

El parametro product puede ser movements o subscription y determina el producto y el tipo de link que se va a generar.

country

string

Debe ser el código ISO 3166-1 alfa-2 del país al que se quiere conectar. Puede ser cl o mx. Por defecto se usará cl.

webhookUrl

string

El parametro webhookUrl es la url a la que se hará el request donde se enviará el link_token generado.

onSuccess

function

La función onSuccess es un callback que se llamará siempre que se cree un Link con éxito.

onExit

function

La función onExit es un callback que se llamará siempre que un usuario cierre el widget.

onEvent

function

La función onEvent es un callback que se llamará cada vez que un usuario realiza una acción de valor.

Métodos del objeto Widget

Al tener el object widget creado puedes utilizar sus métodos para interactuar con Fintoc. Puedes utilizar open, close y destroy.

Método

Descripción

widget.open()

Con el método open puedes abrir el widget de Fintoc en cualquier momento.

widget.close()

Con el método close puedes cerrar el widget de Fintoc en cualquier momento.

widget.destroy()

Con el método destroy puedes eliminar la instancia del widget de tu página o aplicación. Si quieres volver a abrir el widget después de utilizar este método deberás crear otra instancia con Fintoc.create()

📘

Como utilizar widget.destroy()

Al utilizar Fintoc.create(args) se crea un iframe dentro de tu aplicación. Entonces, en caso de estar en una SPA, se puede eliminar el iframe utilizando este método. Y si se necesita volver a abrir el widget, se deberá crear una nueva instancia del widget utilizando Fintoc.