With Stripe settlements, Payfriend pulls your payouts from Stripe and books each payout as one voucher with gross revenue, fees and output VAT. The connection is read-only: Payfriend cannot move money, create charges or change anything in your Stripe account.

This is booking of payouts. Card charges on your own subscriptions are a different connection under Subscriptions.

Before you start

You have administrator access to the Stripe account.
Your accounting system is connected in Payfriend (e-conomic, Dinero, Billy or Business Central).
Your bank is connected so the STRIPE line can be matched once the voucher is booked. See Connect your bank.
The Settlements menu item (under Bank in the sidebar) must be enabled for the company. If it is missing, message us in chat.

Connect Stripe

1. Open the connection

Either:

Settlements (under Bank in the sidebar) → Connect with Stripe
Settings → Stripe settlements → Connection

2. Approve read access

Click Connect with Stripe. You are sent to Stripe, sign in, and approve Payfriend's read access to payouts.

Payfriend fetches history and new payouts automatically. You can close the page during sync: we will notify you when there is something to see.

Alternative: restricted API key

If one-click connect is not available, open Advanced: paste a restricted key on the connection screen. Paste a restricted key (rk_) with read access to Balance transactions, Payouts and Invoices. The key is stored encrypted and is never shown again.

Choose accounts

Before the first voucher can be booked, accounts must be set:

Go to Settings → Stripe settlements → Accounts (or follow Choose accounts after connecting).
Choose at least a destination account (net), fee account, revenue account and a VAT code on the gross line.
Save. Changes apply from the next booking; vouchers already booked are not changed.

If you have more than one active bank account, choose Payout lands in under Settings → Stripe settlements → Connection. Otherwise we do not match the bank line.

Cutover date (e-conomic)

If you have already booked Stripe manually in e-conomic, set a cutover date under Settings → Stripe settlements → Booking. Payouts before that date are fetched as history and are not booked in Payfriend. e-conomic is the source of truth for what is already there.

After connecting

Open Settlements → Payouts, choose Needs you, and book the first payout yourself.
If the voucher goes through cleanly, you can turn on auto-booking under Settings → Stripe settlements → Booking.
The bank line is usually matched automatically once the voucher is booked.

You can disconnect Stripe under Settings → Stripe settlements → Connection. Payouts already fetched stay in Payfriend.

Check that it worked

Status is Connected (read access)
Destination, fee, revenue and VAT code are set
Payouts show under Needs you, or you are waiting for the first Stripe payout

Common issues

Symptom	Cause	Fix
No payouts	Stripe has not paid out yet	Wait. We fetch every night automatically.
Cannot book	Missing accounts or VAT code	Complete Settings → Stripe settlements → Accounts.
Connection rejected	Access revoked in Stripe	Connect again under Settings → Stripe settlements → Connection.
Old payouts visible but cannot book	Cutover date	Check the date under Settings → Stripe settlements → Booking.

Connect Stripe for settlements