VeloBank Integration — Import Transactions to Freenance

Importing Transactions from VeloBank

VeloBank is a digital-first Polish bank that offers CSV export of your transaction history. Once you have the file, you can upload it to Freenance — the system automatically categorizes spending, detects subscriptions, and shows your Financial Freedom Runway.

Integration status (May 2026): We add support for new VeloBank CSV variants based on user reports. If your import returns "0 incomes, 0 expenses created", email us with an anonymized sample — we add new format support within 1–3 business days.

Step 1: Export from VeloBank

1. Sign in to the VeloBank mobile app or online banking.
2. Go to Account → Transaction history (the exact name varies by app version).
3. Select the account you want to export.
4. Set the date range.
5. Choose CSV format and generate the file.
6. Save the file to your computer.

Note: Freenance imports CSV and MT940 files only. XLS/Excel is not supported — if VeloBank only offers XLS, open the file in Excel/LibreOffice and save as CSV (UTF-8).

Step 2: Rename the file

Freenance expects CSV files to follow this naming convention:

velo-{account-number}.csv

Example: velo-12345678901234567890123456.csv (full IBAN account number, no spaces, no PL prefix).

Step 3: Import to Freenance

1. Sign in to Freenance.
2. Open Configuration → Bank import.
3. Drag the CSV onto the upload area or click Choose file.
4. Click Upload.
5. After a few seconds the import job will report how many incomes and expenses were created and the date range covered.

What happens after import

• Automatic categorization based on transaction descriptions; learns from your edits.
• Recurring payment detection — subscriptions, loan instalments, rent get flagged as recurring.
• Duplicate detection — overlapping import windows skip transactions already in your database.
• Internal transfer detection — transfers between your own accounts in Freenance aren't counted as income or expense.

Security

• No bank account access — Freenance never asks for your VeloBank login or password.
• Encrypted transmission — all uploads use HTTPS.
• Delete any time — from your Freenance account you can delete individual transactions, an entire account, or all your data (GDPR-compliant).

Other banks in Freenance

Freenance also imports from PKO, ING, Revolut, Credit Agricole, Nest Bank, Millennium, and mBank. All accounts live in one dashboard with one categorization model and one budget.

Get started

👉 Sign up for Freenance and import your first VeloBank file. If something doesn't work — email us at hello@freenance.io.

FAQ

What file format does VeloBank export and does Freenance support it?

VeloBank typically offers CSV from the mobile app or online banking. Freenance imports CSV and MT940 — XLS is not supported, so if your version of the app only offers XLS, open it in Excel or LibreOffice and save as CSV (UTF-8) before uploading.

Do I need to share my VeloBank login with Freenance?

No. Freenance never asks for your VeloBank login or password. The integration is one-directional: you export a CSV from VeloBank, then upload it to Freenance — credentials stay between you and the bank.

How should I name the VeloBank CSV before uploading?

Use velo-{26-digit-IBAN}.csv — the full account number, no spaces, no PL prefix. The IBAN-based filename allows Freenance to recognize repeat imports for the same account and skip duplicates automatically.

My VeloBank import created 0 transactions — what happened?

Most likely your CSV variant isn't parsed yet. Send an anonymized sample to hello@freenance.io and a new variant is typically added within 1–3 business days; in the meantime double-check the file is genuine CSV (not XLS) and uses UTF-8.

Can I import historical transactions from before I started using Freenance?

Yes. Export the full date range VeloBank lets you generate (often several months or more at once), name the file correctly, and upload. Freenance will categorize the entire history and use it to seed your trends and runway calculations.