Automatically import bank transactions via Enable Banking (PSD2/Open Banking) into pretix
Project description
pretix-enablebanking
Connects pretix to your bank via Enable Banking (PSD2/Open Banking). Once configured, it periodically fetches bank transactions and feeds them into pretix's bank transfer pipeline — automatically matching incoming payments to orders.
Key capabilities:
- OAuth-based bank connection via 400+ European banks (PSD2)
- Automatic and on-demand transaction import
- Multi-account support with per-account activation toggle
- Configurable auto-fetch interval (every 1h, 4h, 12h, or 24h)
- Works at organizer level (one connection per organizer)
Screenshots
Import — manual fetch & job history
Settings — bank connection & API credentials
How it works
- You register an app at Enable Banking and get an App ID + RSA private key.
- You enter those credentials in the plugin settings and initiate an OAuth flow to connect your bank account.
- After authorization, Enable Banking provides access to your bank accounts. You activate the ones you want to import from.
- The plugin fetches transactions (automatically or on demand) and creates
BankImportJobrecords, which pretix then processes to match payments against open orders.
The transaction import runs as a Celery task and uses Enable Banking's paginated transactions API. The last-fetched date per account is tracked to avoid re-importing.
Installation
pip install pretix-enablebanking
Then run migrations and restart the server:
python -m pretix migrate
The plugin registers itself automatically via the pretix.plugin entry point — no manual INSTALLED_APPS edit needed.
Development installation
git clone https://github.com/nicoknoll/pretix-enablebanking.git
cd pretix-enablebanking
pip install -e .
Setup in pretix
1. Get Enable Banking credentials
- Sign up at developers.enablebanking.com and create an application.
- Generate an RSA key pair. Register the public key with Enable Banking and keep the private key (PEM format).
- Note your Application ID.
2. Configure the plugin
In the pretix backend, go to your organizer → Bank transfer → Enable Banking settings:
- Application ID — the App ID from Enable Banking
- Private key (PEM) — your RSA private key (
-----BEGIN PRIVATE KEY-----format) - Country — used to filter the list of available banks (ASPSPs)
- Auto-fetch interval — how often transactions should be fetched automatically (set to "disabled" to import manually only)
Save, then select your bank from the dropdown and click Connect with bank. You'll be redirected to Enable Banking's hosted authorization page where you log into your bank and grant consent.
After authorization, you're redirected back and your accounts appear in the settings. Activate the accounts you want to import from and save.
3. Import transactions
Go to Bank transfer → Automatic import to:
- Trigger a manual import (optionally specify a start date)
- View recent import jobs and their status
- See when your bank connection expires (Enable Banking consent is typically valid for 90 days — renew before it expires)
Testing with the sandbox
Enable Banking provides a sandbox environment with a mock bank. Use these credentials when connecting Aachener Bank (country: DE):
| Field | Value |
|---|---|
| VR NetKey | VRK1234567890ALL |
| PIN | password |
| OTP | 123456 |
The import view shows a Sandbox mode warning when a mock bank is connected.
Dependencies
| Package | Purpose |
|---|---|
pretix >= 2.7.0 |
Host platform |
requests |
HTTP calls to Enable Banking API |
PyJWT |
RS256-signed JWT for API authentication (transitive via pretix) |
Python 3.10+ required.
Permissions
The plugin operates at organizer level. Users need can_change_organizer_settings to access settings and trigger imports.
License
MIT — see LICENSE.
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pretix_enablebanking-1.0.4.tar.gz.
File metadata
- Download URL: pretix_enablebanking-1.0.4.tar.gz
- Upload date:
- Size: 750.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
064714e0e4c508ec3658784a44a6f95de0d2b6631d994c892bd242ae2deda17a
|
|
| MD5 |
70052ad67425fb0b6a2a6f259d577a4c
|
|
| BLAKE2b-256 |
9cdbb4799fb0ce8e9f519c1b532972ed2206b10583f286c9ba8587ab72607d11
|
File details
Details for the file pretix_enablebanking-1.0.4-py3-none-any.whl.
File metadata
- Download URL: pretix_enablebanking-1.0.4-py3-none-any.whl
- Upload date:
- Size: 34.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
09a015e013bcdeb28abcc851bcbbbbb629623d748468be08d76bbe33a80445cc
|
|
| MD5 |
45ad26f1f090051084a5c5deb4536176
|
|
| BLAKE2b-256 |
4401c1c4b7cd8772d9422c829fc5b8e10358e58a639c79bf2531e2122216c815
|