Flujo de integración

Usa el dashboard para conectar tu propia cuentaTe recomendamos integrar el Widget solo si quieres conectar la cuenta bancaria de tus usuarios. Si quieres obtener datos de tu propia cuenta bancaria, deberías conectar tu cuenta usando el Dashboard ya que es mucho más fácil.Aprende cómo conectar tu cuenta usando el Dashboard aquí.

El flujo de conexión comienza cuando tu usuario quiere conectar su cuenta bancaria a tu app:

Entonces, expresándolo en palabras:

Necesitas crear un Link Intent con el endpoint de creación. Este objeto representa la intención de conexión del usuario y recibe todas las configuraciones necesarias para abrir el Widget en tu frontend.
Para actualizar correctamente los movimientos en tu cuenta bancaria, asegúrate de que la cuenta usada para crear el Link tenga los permisos necesarios para revisar la página de saldo y movimientos, la cartola histórica, la cartola provisoria, y cualquier otra página relacionada con movimientos. Para conectar una cuenta en Modo de Prueba, consulta nuestra guía de pruebas.
El Link Intent que acabas de crear tiene un campo llamado widget_token. Necesitas abrir el Widget en tu frontend usando este token y la API Key pública:

<script>
  window.onload = () => {
    const widget = Fintoc.create({
      publicKey: '<FINTOC_PUBLIC_KEY>',
      widgetToken: 'li_XXXXXXXX_sec_YYYYYYYY',
    });
  };
</script>

Una vez que la conexión sea exitosa, recibirás el objeto Link Intent como parámetro en tu callback onSuccess. Este objeto ahora tendrá el exchange_token. Esta es una clave temporal que te permite obtener la información del Link, incluido el link_token, para que luego puedas acceder a toda la información proporcionada por tu usuario:

<script>
  window.onload(() => {
    const widget = Fintoc.create({
      publicKey: '<FINTOC_PUBLIC_KEY>',
      widgetToken: 'li_XXXXXXXX_sec_YYYYYYYY',
      onSuccess: (linkIntent) => {
      	const exchangeToken = linkIntent.exchangeToken;
        sendExchangeTokenToBackend(exchangeToken);
        processSucceededConnection();
      },
    });
  });
</script>

Desde tu backend, usa el exchangeToken y tu secret key para obtener la información del Link usando el endpoint exchange.

¡Y eso es todo!

Productos e instituciones Prueba tu integración

Inicio

Recursos

Pagos

Transferencias

Domiciliación bancaria

Movimientos

Flujo de integración