python-figo

Python bindings for the figo Connect API: https://docs.finx.finleap.cloud/stable/

Usage

First, you have to install the package:

pip install -e git+https://github.com/W-Z-FinTech-GmbH/python-figo.git#egg=python-figo

Now you can create a new session from the demo access token and read data:

from figo import FigoSession

session = FigoSession(
    "ASHWLIkouP2O6_bgA2wWReRhletgWKHYjLqDaqb0LFfamim9RjexTo22ujRIP_cjLiRiSyQX"
    "yt2kM1eXU2XLFZQ0Hro15HikJQT_eNeT_9XQ"
)

# Print out a list of accounts including its balance
for account in session.accounts:
    print(account)
    print(account.balance)

# Print out the list of all transactions on a specific account
for transaction in session.get_account("A1.2").transactions:
    print(transaction)

It is just as simple to allow users to login through the API:

import webbrowser
from figo import FigoConnection, FigoSession

connection = FigoConnection(
    "<client ID>", 
    "<client secret>", 
    "http://my-domain.org/redirect-url"
)

def start_login():
    # open the webbrowser to kick off the login process
    webbrowser.open(
        connection.login_url(
            scope="accounts=ro transactions=ro", 
            state="qweqwe"
        )
    )

def process_redirect(authentication_code, state):
    # handle the redirect url invocation, which gets passed an authentication 
    # code and the state (from the initial login_url call)

    # authenticate the call
    if state != "qweqwe":
        raise Exception("Bogus redirect, wrong state")

    # trade in authentication code for access token
    token_dict = connection.convert_authentication_code(authentication_code)

    # start session
    session = FigoSession(token_dict["access_token"])

    # access data
    for account in session.accounts:
        print(account.name)

You can find more (deprecated) documentation at http://python-figo.readthedocs.org

Environment variables

• FIGO_API_ENDPOINT
  • Override the default API endpoint by setting the environment variable.
• FIGO_CLIENT_ID, FIGO_CLIENT_SECRET
  • Override to run tests with a client other than the demo client
• FIGO_PAYMENTS
  • boolean value to determine if payments need to be check on unit testing (default: True)