Skip to main content
Para comenzar a usar Fintoc, solo necesitas crear una cuenta en nuestro Dashboard y seguir estos tres pasos:
  1. Crear un Link de prueba y obtener su link_token
  2. Obtener tus API keys para interactuar con la API
  3. Obtener los movimientos y saldos del Link de prueba que acabamos de crear
Para usar Movements en modo live, tu negocio necesita un identificador tributario de empresa, una cuenta bancaria a nombre de tu empresa y un correo con el dominio de tu empresa. Fintoc no acepta personas naturales. Revisa Quién puede usar Fintoc.
Repositorio de ejemploPuedes revisar el repositorio fintoc-com/quickstart para ver ejemplos de cómo integrar la API de Fintoc en tu código con distintos lenguajes mientras usas nuestro Widget.
Un Link representa una conexión (o link) entre la cuenta de una entidad financiera y Fintoc. Eso significa que cuando decimos “crear un Link de prueba”, queremos decir que conectes una cuenta de prueba (de tu entidad financiera preferida) a Fintoc. La forma más rápida de vincular una cuenta con Fintoc es a través de nuestro Dashboard. Para lograr esto, primero necesitas crear una cuenta en el Dashboard de Fintoc (no confundir con, por ejemplo, tu cuenta bancaria, que usaremos más tarde para crear un Link). Una vez que tu cuenta de Fintoc esté creada, podrás crear Links. Al crear un nuevo Link, necesitarás seleccionar tu banco y luego usar las credenciales de tu cuenta bancaria para iniciar sesión. Como estamos creando un Link de prueba, puedes usar cualquier credencial del sandbox en cualquier banco. Por ejemplo, intenta usar 41614850-3 como usuario y jonsnow como contraseña.
Asegúrate de que la cuenta vinculada tenga los permisos necesariosPara 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.
Una vez que hayas creado el Link de prueba, tu link_token se mostrará en el Dashboard. El link_token representa tus credenciales bancarias, y tendrás que usarlo cada vez que quieras obtener el saldo o los movimientos de ese Link.

​
Paso 2: Obtén tus API keys

Cada interacción con la API de Fintoc debe autenticarse con las API keys de tu cuenta de Fintoc. Si una interacción con la API no incluye tu API key o incluye una API key incorrecta, Fintoc devuelve un error. Cada cuenta de Fintoc tiene dos pares de claves: un par corresponde al sandbox, mientras que el otro par corresponde al entorno real de la API. Cada recurso se almacena ya sea en el sandbox o en el entorno real de la API, y los recursos de un entorno no pueden ser manipulados por recursos del otro entorno. Tus API keys estarán disponibles en el Dashboard. En este caso, debes usar la secret key del sandbox. Para identificarla fácilmente, Fintoc agrega el prefijo sk_test_.

​
Paso 3: Obtén el saldo y los movimientos

Para hacerlo más fácil, llamaremos a la API por primera vez usando cURL. También puedes usar Postman o una de nuestras librerías open source. Para obtener los movimientos de una cuenta, primero necesitas el ID que Fintoc le asignó a dicha cuenta. Abre tu terminal y pega el siguiente código para listar cada cuenta asociada a un Link:
Para cada cuenta, deberías poder ver el saldo total y la información de su titular. Puedes usar el siguiente código para listar los movimientos de una cuenta:
¡voilà! Deberías poder ver los movimientos de esa cuenta. ¡Estás listo para empezar a integrar con Fintoc!