¿Obtener la cartola por API? Con Fintoc se puede. Toma el tiempo, en menos de 5 minutos podrás obtener tus movimientos siguiendo este tutorial.

*Por ahora estamos funcionando solo en Chile. Si eres de otro país o tu banco no aparece, escríbenos a quierounbanco@fintoc.com

Primero lo primero

  • Créate una cuenta en app.fintoc.com
  • Obtén una API Key. Anda a app.fintoc.com/api-keys y aprieta "agregar API Key"

    La API Key es un token que permite identificarte. Es secreto, así que no debes compartirlo con nadie. La API Key que debes utilizar en este tutorial es la secret. Para identificarla más fácilmente le pusimos el prefijo sk_live_.
Vista de las API Keys

Con lo anterior ya tenemos la base lista. Debes copiar tu API Key ya que la utilizarás en el futuro.

Linkea(conecta) tu cuenta bancaria

Ahora la parte interesante: Conectarte con tu banco

  • Debes ir a https://app.fintoc.com/links y apretar en Nuevo link personas/empresas según corresponda
  • Luego, seleccionar tu banco y hacer el login correspondiente
Widget de Fintoc
  • Luego de hacer login, aparecerá tu Link Token. Esto representa tus credenciales (para evitar enviar tus credenciales en cada requests) por lo que debes guardarlo en un lugar seguro.

¡Listo! Ya tienes todo lo necesario para consultar la API. Tienes las dos cosas que necesitas:

  1. Tienes tu API Key, en mi caso es: sk_live_D9BSZGZA2pZFDrCLDKovSZ_xtVQSDMuvbumjK2KiG1h34ZvT
  2. Tienes tu Link token, en mi caso es: aZnyJGj7iNWkdENl_token_SyL83zCbM7apMEqpJyayyjQR

Manos a la obra

Para hacer este tutorial más fácil de seguir y para que no dependa de ningún lenguaje en particular, haremos todo desde la consola utilizando curl.

Para ver los movimientos de una cuenta en particular, necesitamos el ID que Fintoc le dio a dicha cuenta. Lo primero que haremos entonces es listar todas las cuentas que Fintoc encontró.

Debemos abrir nuestro terminal y pegar el siguiente código:

curl https://api.fintoc.com/v1/accounts?link_token=TU_LINK_TOKEN -H "Authorization: TU_API_KEY"
Código para listar tus cuentas

En mi caso quedó de la siguiente manera:

curl https://api.fintoc.com/v1/accounts?link_token=aZnyJGj7iNWkdENl_token_SyL83zCbM7apMEqpJyayyjQR -H "Authorization: sk_live_D9BSZGZA2pZFDrCLDKovSZ_xtVQSDMuvbumjK2KiG1h34ZvT"
Mi código para listar tus cuentas

Luego de hacer el llamado a la API, esta nos retornará una lista con las cuentas:

Lista de cuentas

Podemos ver que estas credenciales en particular tienen asociadas dos cuentas. La primera es una cuenta corriente y la segunda una linea de crédito. Listemos los movimientos de la cuenta corriente, es decir, la con ID 8pvbQlvmT3kKEzwG.

Vamos a llamar a la API de la siguiente manera:

curl https://api.fintoc.com/v1/accounts/ID_CUENTA/movements?link_token=TU_LINK_TOKEN -H "Authorization: TU_API_KEY"
Código para obtener los movimientos

A mi me quedó así:

curl https://api.fintoc.com/v1/accounts/8pvbQlvmT3kKEzwG/movements?link_token=aZnyJGj7iNWkdENl_token_SyL83zCbM7apMEqpJyayyjQR -H "Authorization: sk_live_D9BSZGZA2pZFDrCLDKovSZ_xtVQSDMuvbumjK2KiG1h34ZvT"
Mi código para obtener los movimientos

¡VOILA!

[
   {
      "id":"QbO7Y7RHvP7Pe4Zl",
      "description":"Pago:starken Ricardo L",
      "amount":-2020,
      "currency":"CLP",
      "post_date":"2020-06-30T00:00:00Z",
      "transaction_date":"2020-06-26T15:22:51.000Z",
      "type":"other",
      "recipient_account":null,
      "sender_account":null,
      "comment":null
   },
   {
      "id":"VXDKYjpHDLB08Eyq",
      "description":"Pago:ferreteria Garach",
      "amount":-600,
      "currency":"CLP",
      "post_date":"2020-06-30T00:00:00Z",
      "transaction_date":"2020-06-26T15:53:26.000Z",
      "type":"other",
      "recipient_account":null,
      "sender_account":null,
      "comment":null
   },
   {
      "id":"3BX28ZBHzwV087bo",
      "description":"Traspaso De:Cristobal Griffero Campo",
      "amount":20000,
      "currency":"CLP",
      "post_date":"2020-06-30T00:00:00Z",
      "transaction_date":"2020-06-29T21:02:24.000Z",
      "type":"transfer",
      "recipient_account":null,
      "sender_account":{
         "holder_id":"180240209",
         "number":"2571292",
         "institution":null,
         "holder_name":null
      },
      "comment":"SIN USO"
   },
...
]
Código para obtener los movimientos

Listo! Ya podemos preguntarle a la API por nuestros movimientos y hacer todo tipo de cosas extrañas.

Así me sentí la primera vez que lo hice

ps 1: Existe una librería en Python y otra en Node para hacer todo esto más rápido

ps 2: Obviamente cambié las API Key y tokens de las fotos al terminar este tutorial :)


Si quedaste con alguna duda o quieres saber más, puedes enviarme un mail a cristobal@fintoc.com