Stripe payments CSV importer for Beancount

This tool converts a Stripe payments CSV for FOSSY 2026 into Beancount transactions, including currency conversions.

Usage

This program requires a Java runtime environment (tested with OpenJDK 25). On Debian 13 (Trixie):

sudo apt install openjdk-25-jre

Ensure you have a ~/.config/oxrlib.ini with a valid app_id. This tool doesn't use oxrlib directly, but integrates with the oxrlib config and cache.

You can test the output in Beancount by adding the following header entries to define the accounts:

2006-03-01 open Assets:Receivable:Accounts
2006-03-01 open Expenses:Conferences:Services
2006-03-01 open Liabilities:UnearnedIncome:Conferences:Registrations
2006-03-01 open Equity:Realized:CurrencyConversion
2006-03-01 open Income:Donations

Then run Beancount with:

bean-report [your file] balances

Building

To build you need a Java SDK (tested with OpenJDK 25) and Clojure. On Debian 13 (Trixie):

sudo apt install openjdk-25-jdk clojure

To build, run:

bin/build

This will output a JAR file like target/stripe-importer-x.x.x-standalone.jar, where the version number is based on the Git revision.

Development

Run tests with:

bin/test

You can run without building using:

bin/dev resources/example-stripe-payments.csv

The project is set up for development in Emacs and CIDER-mode. Open a source file and run cider-jack-in.