Obtén movimientos bancarios

AdvertenciaEsta guía está pensada para ser seguida por un backend. Tu Secret Key nunca debe enviarse al frontend.

Antes de empezar a usar Fintoc, necesitas obtener la Secret Key de tu cuenta de Fintoc. Se usará a lo largo de esta guía, así que asegúrate de seguir la guía sobre cómo obtener tus API keys para obtener tu Secret Key en vivo. Para obtener los movimientos de tu cuenta bancaria, primero necesitas crear un Link y obtener su Link Token. Puedes hacerlo desde el dashboard, siguiendo esta guía. Una vez que tengas tu Link Token, ¡podemos empezar!

TipComo necesitaremos usar nuestra Secret Key y un Link Token, alguna información sensible debe ser reemplazada por ti para que el código de esta guía sea completamente funcional. De ahora en adelante, escribiremos FINTOC_SECRET_KEY para representar la Secret Key que debes obtener y LINK_TOKEN para representar el Link Token requerido para que cualquiera de este código funcione.

Herramientas

Esta guía muestra cómo usar la API de Fintoc usando el SDK de Python, el SDK de Node y cURL. La herramienta cURL puede reemplazarse con cualquier herramienta que permita realizar peticiones HTTP a través de la terminal y scripts de shell (por ejemplo, Wget). Los SDKs pueden instalarse con los siguientes comandos:

Python

pip install fintoc

Node

# Usando npm
npm install fintoc

# Usando yarn
yarn add fintoc

Al usar cualquiera de los SDKs, por favor asegúrate de estar usando la última versión. Puedes encontrar el changelog y las versiones de los SDKs aquí (SDK de Python) y aquí (SDK de Node).

Obtener la cuenta correcta

Como menciona la guía para crear un Link desde el dashboard, un Link representa la combinación usuario/contraseña del banco. Esto significa que un Link puede tener más de una cuenta (por ejemplo, quizás tienes una cuenta corriente y una cuenta de ahorro bajo la misma combinación usuario/contraseña). ¡Decidamos cuál de nuestras cuentas tiene la información que necesitamos! Primero, listemos todas nuestras cuentas:

from fintoc import Fintoc

fintoc_client = Fintoc("FINTOC_SECRET_KEY")
link = fintoc_client.links.get("LINK_TOKEN")
accounts = link.accounts.all()

for account in accounts:
    print(account.serialize())

Node

import { Fintoc } from 'fintoc';

async function main() {
    const fintocClient = new Fintoc('FINTOC_SECRET_KEY');
    const link = await fintocClient.links.get('LINK_TOKEN');
    const accounts = await link.accounts.all();

    for await (const account of accounts) {
        console.log(account.serialize());
    }
}

main();

cURL

curl --request GET \
    --url 'https://api.fintoc.com/v1/accounts/?link_token=LINK_TOKEN' \
    --header 'Authorization: FINTOC_SECRET_KEY'

La salida de cada uno de los snippets anteriores debería verse algo así:

Python

# Salida formateada
{
    "balance": {
        "available": 0,
        "current": 0,
        "limit": 0
    },
    "currency": "CLP",
    "holder_id": "199586335",
    "holder_name": "DANIEL ALEJANDRO LEAL BITRAN",
    "id": "acc_MNejK7B76wbJGbl1",
    "name": "Cuenta de Ahorro",
    "number": "340127831",
    "object": "account",
    "official_name": "Cuenta de Ahorro",
    "refreshed_at": "2021-11-30T17:53:59.438000+00:00",
    "type": "savings_account"
}
{
    "balance": {
        "available": 0,
        "current": 0,
        "limit": 200000
    },
    "currency": "CLP",
    "holder_id": "199586335",
    "holder_name": "DANIEL ALEJANDRO LEAL BITRAN",
    "id": "acc_O38ioEA4QejjnGeb",
    "name": "Cuenta Corriente",
    "number": "3945154",
    "object": "account",
    "official_name": "Cuenta Corriente MN",
    "refreshed_at": "2021-11-30T16:54:23.441000+00:00",
    "type": "checking_account"
}

Node

// Salida formateada
{
  balance: {
    available: 0,
    current: 0,
    limit: 0
  },
  currency: 'CLP',
  holder_id: '199586335',
  holder_name: 'DANIEL ALEJANDRO LEAL BITRAN',
  id: 'acc_MNejK7B76wbJGbl1',
  name: 'Cuenta de Ahorro',
  number: '340127831',
  object: 'account',
  official_name: 'Cuenta de Ahorro',
  refreshed_at: '2021-11-30T17:53:59.438000+00:00',
  type: 'savings_account'
}
{
  balance: {
    available: 0,
    current: 0,
    limit: 200000
  },
  currency: 'CLP',
  holder_id: '199586335',
  holder_name: 'DANIEL ALEJANDRO LEAL BITRAN',
  id: 'acc_O38ioEA4QejjnGeb',
  name: 'Cuenta Corriente',
  number: '3945154',
  object: 'account',
  official_name: 'Cuenta Corriente MN',
  refreshed_at: '2021-11-30T16:54:23.441000+00:00',
  type: 'checking_account'
}

cURL

# Salida formateada
[
    {
        "balance": {
            "available": 0,
            "current": 0,
            "limit": 0
        },
        "currency": "CLP",
        "holder_id": "199586335",
        "holder_name": "DANIEL ALEJANDRO LEAL BITRAN",
        "id": "acc_MNejK7B76wbJGbl1",
        "name": "Cuenta de Ahorro",
        "number": "340127831",
        "object": "account",
        "official_name": "Cuenta de Ahorro",
        "refreshed_at": "2021-11-30T17:53:59.438000+00:00",
        "type": "savings_account"
    }
    {
        "balance": {
            "available": 0,
            "current": 0,
            "limit": 200000
        },
        "currency": "CLP",
        "holder_id": "199586335",
        "holder_name": "DANIEL ALEJANDRO LEAL BITRAN",
        "id": "acc_O38ioEA4QejjnGeb",
        "name": "Cuenta Corriente",
        "number": "3945154",
        "object": "account",
        "official_name": "Cuenta Corriente MN",
        "refreshed_at": "2021-11-30T16:54:23.441000+00:00",
        "type": "checking_account"
    }
]

En nuestro caso, queremos usar los datos de nuestra cuenta corriente, así que ahora sabemos que necesitamos usar la cuenta con id acc_O38ioEA4QejjnGeb para buscar nuestros movimientos. El id de tu cuenta debería ser diferente, pero también debería empezar con acc_.

TipDe ahora en adelante, escribiremos ACCOUNT_ID para representar el id de la cuenta que queremos usar.

Obteniendo los movimientos

Ahora que sabemos el id de la cuenta que queremos usar, ¡solo necesitamos usarlo para obtener los movimientos!

from fintoc import Fintoc

fintoc_client = Fintoc("FINTOC_SECRET_KEY")
link = fintoc_client.links.get("LINK_TOKEN")
account = link.accounts.get("ACCOUNT_ID")

movements = account.movements.all()

for movement in movements:
    print(movement.serialize())

Node

import { Fintoc } from 'fintoc';

async function main() {
    const fintocClient = new Fintoc('FINTOC_SECRET_KEY');
    const link = await fintocClient.links.get('LINK_TOKEN');
    const account = await link.accounts.get('ACCOUNT_ID');

    const movements = await account.movements.all();

    for await (const movement of movements) {
        console.log(movement.serialize());
    }
}

main();

cURL

curl --request GET \
    --url 'https://api.fintoc.com/v1/accounts/ACCOUNT_ID/movements?link_token=LINK_TOKEN' \
    --header 'Authorization: FINTOC_SECRET_KEY' \
    --header 'Accept: application/json'

La salida de cada uno de los snippets anteriores debería verse algo así:

# Salida formateada
{
  "id": "mov_J32e7dHabkrqQ48P",
  "description": "Abono por transferencia de Daniel Alejandro Leal Bitrán Rut 19.958.633-5 desde Cuenta Corriente de B.Santander, el 28/11/2021 a las 19:16",
  "amount": 3143097,
  "currency": "CLP",
  "post_date": "2021-11-29T00:00:00.000Z",
  "transaction_date": "2021-11-28T19:16:00.000Z",
  "type": "transfer",
  "recipient_account": None,
  "sender_account": {
    "holder_id": "199586335",
    "number": None,
    "institution": None,
    "holder_name": "Daniel Alejandro Leal Bitran"
  },
  "comment": None,
  "reference_id": None,
  "pending": False,
  "object": "movement"
}
{
  .
  .
  .
}
.
.
.

Node

// Salida formateada
{
  id: 'mov_J32e7dHabkrqQ48P',
  description: 'Abono por transferencia de Daniel Alejandro Leal Bitrán Rut 19.958.633-5 desde Cuenta Corriente de B.Santander, el 28/11/2021 a las 19:16',
  amount: 3143097,
  currency: 'CLP',
  post_date: '2021-11-29T00:00:00.000Z',
  transaction_date: '2021-11-28T19:16:00.000Z',
  type: 'transfer',
  recipient_account: null,
  sender_account: {
    holder_id: '199586335',
    number: null,
    institution: null,
    holder_name: 'Daniel Alejandro Leal Bitran'
  },
  comment: null,
  reference_id: null,
  pending: false,
  object: 'movement'
}
{
  .
  .
  .
}
.
.
.

cURL

# Salida formateada
[
    {
        "id": "mov_J32e7dHabkrqQ48P",
        "description": "Abono por transferencia de Daniel Alejandro Leal Bitrán Rut 19.958.633-5 desde Cuenta Corriente de B.Santander, el 28/11/2021 a las 19:16",
        "amount": 3143097,
        "currency": "CLP",
        "post_date": "2021-11-29T00:00:00.000Z",
        "transaction_date": "2021-11-28T19:16:00.000Z",
        "type": "transfer",
        "recipient_account": null,
        "sender_account": {
            "holder_id": "199586335",
            "number": null,
            "institution": null,
            "holder_name": "Daniel Alejandro Leal Bitran"
        },
        "comment": null,
        "reference_id": null,
        "pending": false,
        "object": "movement"
    },
    {
        .
        .
        .
    },
    .
    .
    .
]

AdvertenciaTen en cuenta que, si bien cada SDK de Fintoc maneja la paginación internamente, el método cURL no pagina los resultados de la API automágicamente. Cada página devuelve por defecto los últimos 30 elementos del recurso. Cada respuesta también devuelve un header Link que contiene la información de paginación. Para obtener la siguiente página, busca el elemento next en el header Link de la respuesta, y haz una petición a esa URL. Las páginas de un recurso terminan cuando no hay elemento next en el header Link de la respuesta.Puedes leer más sobre paginación aquí.

Inicio

Recursos

Pagos

Transferencias

Domiciliación bancaria

Movimientos

Obtén movimientos bancarios

Herramientas

Obtener la cuenta correcta

Obteniendo los movimientos

​Herramientas

​Obtener la cuenta correcta

​Obteniendo los movimientos

Herramientas

Obtener la cuenta correcta

Obteniendo los movimientos