Belvo Python SDK

🚨 Limited maintenance until 31.12.2023

Please be advised that this SDK has transitioned to limited maintenance mode and will no longer receive updates for new features. Essential security updates will continue to be provided until December 31, 2023.

After this date, the SDK will be archived and no further updates will be released. While you are welcome to continue using the code please note that you will be solely responsible for managing and implementing any required security patches or updates.

📕 Documentation

How to use belvo-python: https://belvo-finance.github.io/belvo-python/

If you want to check the full documentation about Belvo API: https://developers.belvo.com

Or if you want to more information about:

📋 Requirements

Python 3.6+

🚀 Getting started

Install using pip:

$ pip install belvo-python

When your user successfully links their account using the Connect Widget, your implemented callback funciton will return the link_id required to make further API to retrieve information.

from pprint import pprint

from belvo.client import Client
from belvo.enums import AccessMode

# Login to Belvo API
client = Client("your-secret-key-id", "your-secret-key", "sandbox")

# Get the link_id from the result of your widget callback function
link_id = result_from_callback_function.id

# Get all accounts
client.Accounts.create(link=link_id)

# Pretty print all checking accounts
for account in client.Accounts.list(type="checking"):
    pprint(account)

Usage (create link via SDK)

You can also manually create the link using the SDK. However, for security purposes, we highly recommend, that you use the Connect Widget to create the link and follow the Usage (create link via widget) example.

from pprint import pprint

from belvo.client import Client
from belvo.enums import AccessMode

# Login to Belvo API
client = Client("your-secret-key-id", "your-secret-key", "sandbox")

# Register a link 
link = client.Links.create(
    institution="erebor_mx_retail",
    username="johndoe",
    password="supersecret",
    access_mode=AccessMode.SINGLE
)

# Get all accounts
client.Accounts.create(link=link["id"])

# Pretty print all checking accounts
for account in client.Accounts.list(type="checking"):
    pprint(account)

Errors and exceptions

By default, when you use our SDK, we automatically return the error. However, if you prefer to receive the exception, you need to set the raise_exception optional parameter to True.

from pprint import pprint
from belvo.client import Client
from belvo.enums import AccessMode
from belvo.exceptions import RequestError

# Login to Belvo API
client = Client("my-secret-key-id", "my-secret-key", "sandbox")

try:
    # Register a link
    link = client.Links.create(
        access_mode=AccessMode.SINGLE,
        institution="erebor_mx_retail",
        username="<username>",
        password="<pass>",
        raise_exception=True, # Set this optional paramter
    )
except RequestError as e:
    # do something with the error
    pprint(e)
else:
    # do something with the link
    pprint(link)

🐍 Development

To release a new version of the SDK to PyPI:

Create a new branch from master.
Use make new-version major|minor|patch to bump a new version.
Create a new pull request for the new version.
Once the new version is merged in master, create a tag matching the new version.

👥 Contributing

Anyone can do something to make belvo-python better, so contributors are always welcome! If you wish to submit a pull request, please be sure check the items on this list:

Tests related to the changed code were executed
The source code has been coded following the OWASP security best practices (https://owasp.org/www-pdf-archive/OWASP_SCP_Quick_Reference_Guide_v2.pdf).
Commit message properly labeled
There is a ticket associated to each PR.

For more details about contributing to this project, please take a look to our guidelines.

Metadata

Release files for belvo-python 0.39.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for belvo-python 0.39.1
File	Size	Uploaded
belvo-python-0.39.1.tar.gz	17.9 kB	Aug 21, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for belvo-python 0.39.1
File	Interpreter	ABI	Platform	Reset
belvo_python-0.39.1-py2.py3-none-any.whl 30.5 kB Aug 21, 2023	Python 3, Python 2	none	any	Details

Total release size: 48.4 kB

Release files / belvo-python-0.39.1.tar.gz

Download URL	belvo-python-0.39.1.tar.gz
Size	17.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`7a323b1817fa4d7f661153314dfd645fba84ca5a44c5e696245ff835187da7ed`
BLAKE2b-256 checksum How to use checksums	`a3a8546a956edb8409bd773a283144ce772aa59ab42bc59feecdc5f8e4feafcb`
Upload date	Aug 21, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.9.9`

Release files / belvo_python-0.39.1-py2.py3-none-any.whl

Download URL	belvo_python-0.39.1-py2.py3-none-any.whl
Size	30.5 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`47f16372ea2d3bb2c3d1d31457827c980f1e05aebe561920a77ae946f263ba50`
BLAKE2b-256 checksum How to use checksums	`d05a95b5064895cae81da99ea6e0cdd5e70d1d022c71545060344e9809d18ddc`
Upload date	Aug 21, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.9.9`