[DEPRECADO] Integración antigua

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

❗️

Integración deprecada

Esta integración ya no la estamos desarrollando y features o productos nuevos usarán la nueva integración del widget de Fintoc. Se recomienda no utilizar esta integración. Dejaremos la documentación para los clientes que utilizaban previamente esta integración.

Instalación

Para integrarte con el Widget, debes incluirlo dentro de un iframe en tu aplicación:

<iframe
  src="https://app.fintoc.com/widget-iframe?public_key=YOUR_PUBLIC_KEY&holder_type=business&redirect_to=https://domain.com&webhook_url=https://domain.com/webhook"
  width="360"
  height="500">
</iframe>

La URL del widget debe incluir los siguientes query params:

Parámetro

Tipo

Descripción

public_key

string

La Public Key asociada a tu cuenta. La puedes encontrar en el Dashboard

holder_type

string

Indica si se quiere conectar una cuenta de persona natural (individual) o empresa (business).

redirect_to

string

Dirección a la que redireccionaremos al usuario cuando finalice el flujo del Widget. Debe ser una dirección HTTPS.
El flujo del Widget finaliza cuando el usuario crea el Link, o cuando el usuario sale del Widget.

webhook_url

string

Endpoint al que Fintoc debe enviar el link_token una vez que se haya creado el Link. Debe ser una dirección HTTPS.

👍

Tip

Puedes usar el Ambiente de test para probar el flujo del widget sin conectar una cuenta real. Solo debes ocupar tu Public Key de prueba.

Resultado al conectar una cuenta

Cuando el usuario termine el flujo del Widget, el Widget redirigirá al usuario a la URL indicada en el parámetro redirect_to. El flujo del Widget termina cuando el usuario crea correctamente el Link, o si es que el usuario cancela la creación del Link. Cuando Fintoc redirige al usuario, se incluye el siguiente query param:

Parámetro

Tipo

Descripción

result

string

Indica el resultado del intento de conectar una cuenta por el Widget. Puede ser link_created si se creó un Link o user_exited si es que el usuario canceló el formulario.

Cuenta conectada exitosamente

Si el usuario crea correctamente el Link, entonces los query params de redirección incluyen también la información del Link:

Parámetro

Tipo

Descripción

link_id

string

Identificador único del Link creado.

username

string

Nombre de usuario de la credencial bancaria que se usó para crear el Link. En Chile es un RUT.

holder_type

string

Indica si el dueño de la cuenta es persona (individual) o empresa (business).

holder_id

string

Identificador del titular de la cuenta. En Chile es un RUT.

institution_id

string

Indica el id de la institución bancaria del Link creado. Ve las Instituciones disponibles.

institution_name

string

Indica el nombre de la institución bancaria del Link creado.

Webhook con Link token

En el momento que se crea el Link por el Widget, Fintoc envía por un webhook el Link creado con su respectivo link token. El link_token te servirá para consultar las cuentas y sus balances, y los movimientos de tu usuario.

Es importante que guardes ese link_token, porque solo se mostrará al crear el Link. Si pierdes el link_token no podrás acceder a los datos del Link, y vas a tener que reconectar la cuenta.

Para mayor seguridad, te recomendamos que guardes el link_token de forma segura. Intenta tomar los mismos resguardos que tomarías si fuera una credencial :cop:

El webhook que te llegará es un Objeto Evento de tipo link.created. Se ve algo así:

{
  "type": "link.created",
  "data": {
    "id": "l6J0WLYbiABXxABN",
    "holder_id": "770208157",
    "username": "416148503",
    "holder_type": "business",
    "created_at": "2020-12-27T19:06:45.986Z",
    "institution": {
      "id": "cl_banco_de_chile",
      "name": "Banco de Chile",
      "country": "cl"
    },
    "link_token": "l6J0WLYbiABXxABN_token_8ZX8ZKCctdRasshzUrWFNn9W",
    "mode": "test",
    "accounts": [
      {
        "id": "XqNDRKQeTnKvpnW5",
        "type": "checking_account",
        "number": "746326042",
        "name": "Cuenta Corriente",
        "official_name": "Cuenta Corriente",
        "balance": {
          "available": 51340323,
          "current": 51340323,
          "limit": 51340323
        },
        "holder_id": "770208157",
        "holder_name": "Galarza Saiz S.A. SpA",
        "currency": "CLP",
        "refreshed_at": null
      }
    ]
  }
}

Ojo que refreshed_at es null por que aún no se ha refrescado por primera vez las cuentas. Para más información de esto, ve cómo funcionan los Links para el Producto Movimientos.

👍

Tip

Para probar el webhook puedes ocupar un webhook de prueba del sitio https://webhook.site/