Skip to main content

A CLI tool for managing bank account connections via GoCardless Bank Account Data API

Project description

GoCardless Bank Account Manager

A command-line interface (CLI) tool for managing bank account connections and retrieving financial data using the GoCardless (formerly Nordigen) Bank Account Data API.

Features

  • 🏦 Browse and connect to banks by country
  • 💰 Check account balances
  • 📊 View and download transactions
  • 🔄 Automatic token management
  • 📥 Bulk transaction export to CSV
  • 📥 Bulk transaction convert to CSV
  • 🌍 Multi-country support
  • 🔐 Secure credential management

Prerequisites

  • Python 3.6 or higher
  • GoCardless Bank Account Data API credentials (Secret ID and Secret Key)
  • Internet connection

Installation

  1. Clone this repository:
git clone https://github.com/thetombrider/gocardlessconnection
cd gocardlessconnection
  1. Install required dependencies:
pip install -r requirements.txt
  1. Create a .env file in the project root with your GoCardless credentials:
GOCARDLESS_SECRET_ID=your_secret_id
GOCARDLESS_SECRET_KEY=your_secret_key

Initial Setup

Generate initial access tokens by running:

python generate_token.py

Usage

Browse and Connect to Banks

python connector.py browse-banks --country IT

Check Account Balances

python connector.py check-balances --bank-id BANK_ID

View Transactions

python connector.py check-transactions --bank-id BANK_ID

Export Transactions to CSV

python connector.py export-transactions --bank-id BANK_ID

Convert Transactions to CSV

python connector.py convert-transactions --bank-id BANK_ID

first release 31/01/2025

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gocardless_fintools-0.3.tar.gz (10.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gocardless_fintools-0.3-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file gocardless_fintools-0.3.tar.gz.

File metadata

  • Download URL: gocardless_fintools-0.3.tar.gz
  • Upload date:
  • Size: 10.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for gocardless_fintools-0.3.tar.gz
Algorithm Hash digest
SHA256 2798f57dcad09b0b7427ec1ebf00ff9c2f7eac5350e36274f2a461f0d9af3996
MD5 c02f566c1fdd9168ab742a0f4276cf97
BLAKE2b-256 00a8a53337662f9a48e76b536eef18664852b82799bb7bdf6a3567e2280f26a9

See more details on using hashes here.

File details

Details for the file gocardless_fintools-0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for gocardless_fintools-0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 799350a1cc296c99e018dbd6ca050fa3ab53b1e72a9e2bca1586d7c1857bb283
MD5 d38563ea03ba675b6b04dc37f6c1e61f
BLAKE2b-256 be7e9e5455a32eeb3bfb3b83f15d03954014d7abde932b66fddc5760c2719836

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page