Banking · Guide 27 of 53
Connecting Stripe
A restricted read key is all Stripe needs. Your Stripe balance becomes a bank account in IQ Books, every charge posts gross with its fee alongside, and each payout pairs with the deposit that lands in your real bank.
Stripe is a sales channel that behaves like a bank account: there is a running balance, every charge, fee, refund and dispute moves it, and money leaves in payouts. IQ Books follows that shape exactly, so a Stripe connection feeds the same pipeline your bank feed uses.
What you need
A restricted key from your Stripe dashboard with read access to balance transactions, charges, refunds, disputes and payouts. Nothing else. A restricted key cannot move money, cannot issue refunds and cannot change anything in your Stripe account — it can only read.
Connecting
- Go to
Banking → Bank accountsand choose Connect a feed, orSettings → Bank feedsif you already have one. - Pick Stripe and paste the restricted key.
- IQ Books creates one bank account for each settlement currency you use. That account stands for your Stripe balance — it is not your high-street bank.
How a charge arrives
This is the part that matters for your accounts. A customer pays £15.00 and Stripe keeps 69p. IQ Books records that the way a statement would show it — as two lines:
- £15.00 in, which you code to sales;
- 69p out, which you code to fees.
Each line is coded on its own, so the sale posts at its full value and the fee posts as a cost. There is no split to unpick and no journal to write. The two still net to the £14.31 that Stripe actually added to your balance, so the Stripe account in IQ Books never drifts from the balance Stripe itself shows you.
How a payout arrives
A payout is a line out of the Stripe account. The deposit into your real bank is a line in on that account. IQ Books pairs the two exactly as it pairs a transfer between two of your own bank accounts, so the money is recorded once and neither side is treated as income.
If the bank side has not arrived yet, the payout waits rather than being guessed at, and says so. It pairs itself when the deposit lands.
Refunds, disputes and multi-currency
- Refunds arrive as their own lines and reduce sales when you code them to the same revenue account.
- Disputes arrive as the charge reversal and the dispute fee, separately, so you can see what a chargeback actually cost.
- More than one settlement currency gives you more than one Stripe account here, one per currency, each with its own balance. That keeps each currency's clearing balance honest instead of mixing them.
Checking it
Open the Stripe account in Banking and compare its balance with the balance in your Stripe dashboard for the same moment. They should agree. If they do not, the usual cause is a period of activity that has not synced yet rather than a coding mistake — the balance is built from the lines, so a missing line shows up as a difference.