Stripe Setup
Stripe is configured per-company inside the app — no .env changes required. The Stripe secret key is stored AES-256-GCM encrypted in the database.
1. Get your Stripe secret key
Log in to dashboard.stripe.com and go to Developers → API keys.
Copy your Secret key (sk_live_... for production or sk_test_... for test mode).
Keep this secret
Your Stripe secret key has full access to your Stripe account. Geekonomics encrypts it at rest — it is never stored in plaintext and is never returned in API responses.
2. Add the key in Geekonomics
- Go to Settings → Stripe Configuration
- Paste your secret key into the Stripe Secret Key field
- Click Save Stripe Key
The app shows a partial hint (last 4 characters) to confirm the key is saved. The full key is never displayed again.
3. Sync transactions
Go to Stripe Sync and click Sync Now to pull charges and refunds. You can optionally set a date range for the first sync to avoid importing years of old data at once.
How sync works
Each Stripe sync:
- Fetches charges, refunds, and payouts from Stripe
- Creates income transactions for charges
- Creates expense transactions for refunds and fees
- Deduplicates by Stripe charge/event ID — re-syncing is safe
- If a payout destination account is set: when Stripe pays out, Geekonomics creates a transfer from your Stripe Clearing account to your chosen bank account
Payout destination
In Stripe Sync, you can designate a payout destination account (typically your business checking account). When payouts arrive, Geekonomics automatically:
- Records income in the Stripe Clearing account as it comes in
- Creates a transfer from Stripe Clearing → your checking account when the payout lands
This keeps Stripe Clearing close to zero and reflects your real bank balance.
Updating the Stripe key
To change the key (e.g. rotating from test to live), go to Settings → Stripe Configuration and enter the new key. The old key is overwritten.
To remove the key, click Remove Key — this disables Stripe Sync until a new key is entered.