What it is for
If you sell through Stripe, your bank account only shows the payouts: one amount every few days, after fees. Once Stripe is connected to Kontavio, every sale comes in on its own, with the gross amount and the buyer. The Stripe fee shows up as a separate expense.
Step 1: Create a read-only key
Kontavio needs a restricted key (it starts with rk_live_). With it Kontavio can read your balance and transactions, but it cannot create payments, refunds or payouts.
- In Stripe, open Developers → API keys
- Click Create restricted key
- Set Read for Balance, Charges and Payouts. Leave everything else on None
- Save the key and copy it
Only Balance is required. With Charges and Payouts Kontavio also shows the buyer's name and the date a payout reaches your bank account.
Step 2: Enter the key in Kontavio
Go to Bank accounts → Add bank account → Connect via API → Stripe, paste the key and click Next. Kontavio checks it with Stripe right away.
Step 3: Choose currencies
Kontavio creates one account for each currency your Stripe account holds a balance in, for example Stripe EUR and Stripe USD. Pick the currencies and set each account to business or personal. Kontavio then imports the last two years of transactions.
How it is booked
| In Stripe | In Kontavio |
|---|---|
| Sale | Income, gross amount |
| Stripe fee | Expense, its own line |
| Refund | Expense |
| Payout to your bank account | Internal transfer, not revenue |
If the bank account Stripe pays out to (Wise, for example) is connected to Kontavio too, Kontavio links the payout with the incoming payment there. The same money is not counted as income twice.
When a customer pays a Kontavio invoice through Stripe, Kontavio recognises the payment and marks the invoice as paid.
Syncing and disconnecting
Kontavio fetches new Stripe transactions every six hours. The sync button on the account card does it right away.
When you disconnect, Kontavio deletes the stored key. The accounts and their past transactions stay unless you choose to delete them as well. You can also revoke the key in Stripe under API keys.