> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bienvenido 👋

> Prueba la API de Fintoc en menos de 5 minutos

Para comenzar a usar Fintoc, solo necesitas crear una cuenta en nuestro [Dashboard](https://app.fintoc.com) y seguir estos tres pasos:

1. Crear un **Link** de prueba y obtener su **link\_token**
2. Obtener tus API Keys para poder interactuar con la API
3. Obtener los movimientos y saldos del **Link** de prueba que acabamos de crear

<Info>
  **[Repositorio de ejemplo](https://github.com/fintoc-com/quickstart)**

  Puedes revisar el repositorio [fintoc-com/quickstart](https://github.com/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.
</Info>

### Paso 1: Crea un Link de prueba

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](https://app.fintoc.com). 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](/es/v2023-11-15/docs/resources/test-mode) en cualquier banco. Por ejemplo, intenta usar `41614850-3` como usuario y `jonsnow` como contraseña.

<Warning>
  **Asegúrate de que la cuenta vinculada tenga los permisos necesarios**

  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.
</Warning>

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**.

<Frame>
  <img width="40% " src="https://mintcdn.com/fintoc-49b8bee8/SkvJJ-DZ5D4yC6tQ/images/d586d550d421ebc19454cc1715d1b17d83d3ee3de74c1808651fe56331140d0b-image.png?fit=max&auto=format&n=SkvJJ-DZ5D4yC6tQ&q=85&s=c9f8ab86f7ef6ed1e684729c1feec594" data-path="images/d586d550d421ebc19454cc1715d1b17d83d3ee3de74c1808651fe56331140d0b-image.png" />
</Frame>

### Paso 2: Obtén tus API Keys

Cada interacción con la API de Fintoc debe autenticarse con las [API Keys](/es/v2023-11-15/docs/home/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 devolverá un error.

Cada cuenta de Fintoc tiene dos pares de claves: un par corresponde al [sandbox](/es/v2023-11-15/docs/resources/test-mode), mientras que el otro par corresponde al entorno real de la API. Cada recurso se almacena ya sea en el [sandbox](/es/v2023-11-15/docs/resources/test-mode) 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](https://app.fintoc.com). En este caso, debes usar la **Secret Key** del [sandbox](/es/v2023-11-15/docs/resources/test-mode). Para identificarla fácilmente, agregamos 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](https://curl.se/). También puedes usar [Postman](https://www.postman.com/) o una de nuestras [librerías open source](/es/v2023-11-15/docs/resources/libraries-and-integrations).

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**:

```curl theme={null}
curl https://api.fintoc.com/v1/accounts?link_token=YOUR_LINK_TOKEN \
-H "Authorization: YOUR_SECRET_API_KEY"
```

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:

```curl theme={null}
curl https://api.fintoc.com/v1/accounts/ACCOUNT_ID/movements?link_token=YOUR_LINK_TOKEN \
-H "Authorization: YOUR_SECRET_API_KEY"
```

¡*voilà!* Deberías poder ver los movimientos de esa cuenta.

¡Estás listo para empezar a integrar con Fintoc!
