Stripe Sync

Connecting Stripe lets you import your Stripe charges and refunds directly into Geekonomics.

How It Works

Stripe sync works the same way as Square: charges post to the Stripe Clearing account, and payouts create transfers from Stripe Clearing to your designated checking account. This keeps your actual bank account balance accurate while giving you visibility into the fee-adjusted net.

Adding Your Stripe Key

Stripe uses a secret API key (not OAuth). Your key is stored encrypted per-company in the database — not in a shared config file.

1. Go to Settings → Stripe Configuration (admin only)
2. Paste your sk_live_... (production) or sk_test_... (test mode) key
3. Click Save Stripe Key

The settings page shows only the last 4 characters of the key after saving.

Running a Sync

1. Go to Stripe Sync in the left sidebar
2. Optionally set a date range
3. Click Sync Now

Geekonomics imports completed charges and refunds, deduplicating by Stripe charge ID. Refunds appear as negative income entries. Stripe fees are recorded separately so you can see gross revenue and fees in the Stripe Fee Impact report.

The sync log at the bottom shows all past syncs.

Setting Your Payout Destination

1. Go to Stripe Sync
2. Find the Payout Destination section
3. Select your checking account
4. Click Save

Once set, future syncs will create transfers from Stripe Clearing to your checking account when Stripe payouts are detected.

Customer Matching

When Geekonomics imports a Stripe charge, it attempts to match the Stripe customer's email to an existing client in your client list. If a match is found, the transaction is linked to that client automatically. If no match is found, the transaction is imported without a client link (you can assign it manually later).

Removing Your Stripe Key

Go to Settings → Stripe Configuration and click Remove Key. Existing synced transactions are not affected.