Skip to main content

​
Primera lectura de un banco

De cero a los movimientos del mes en cuatro llamadas. Necesitas una API key con el permiso banking:read escrito en ella.
1

Conecta el banco con Tupana Link

Crea una sesión con capabilities: ["banking"] y abre el widget para tu usuario. Él elige el banco y entra con su clave; tú nunca la ves.
Cuando el banco acepta la clave recibes connection.active con el connection_id (cred_…). Guárdalo: es la conexión.
2

Lista las cuentas de esa conexión

Cada cuenta trae type/subtype, number_mask y balances con refreshed_at. Ese es el saldo de la última lectura: la API nunca va al banco cuando la llamas.
3

Trae los movimientos del mes

Pagina con page hasta que links.next sea null.
4

Interpreta direction, status y counterparty

  • amount no lleva signo: direction: "inbound" entró, "outbound" salió.
  • status: "pending" todavía no está contabilizado; puede desaparecer o volver como posted. Trabaja con posted para cerrar el mes.
  • counterparty trae a quien pagó o cobró, con RUT cuando Tupana lo resuelve. category dice qué es el dinero.

​
Cuándo volver a leer

Tupana lee cada banco en su propio ciclo y refreshed_at te dice cuándo fue la última vez. Llamar más seguido no trae datos más frescos. Si una conexión pasa a requires_action, el usuario tiene que reautorizarla.