With Settlements, Payfriend pulls your payouts from Stripe and books each payout as one voucher with gross, fee and VAT. The connection is read-only: Payfriend cannot move money or create charges in your Stripe account.
This is booking of payouts. The same Stripe connection is also used for subscriptions. The full walkthrough of the page is in Settlements from Stripe and MobilePay.
Before you start
You have administrator access to the Stripe account.
Your accounting system is connected under Settings → Accounting (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 module is switched on. If it is not under Bank in the menu, open Settings → Settlements and click Enable settlements.
Connect Stripe
1. Open the connection
Either:
Settings → Connections, and click Connect Stripe
Bank → Settlements, and click Connect with Stripe
2. Approve read access
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 meanwhile.
Alternative: restricted API key
If one-click connect is not ready, open Advanced: paste a restricted key. Paste a restricted key (starting with rk_) with read access to Balance transactions, Payouts and Invoices, and click Test and connect. The key is stored encrypted and is never shown again. A secret key (sk_) is rejected.
Choose accounts and bank
Go to Settings → Settlements. The page has three tabs: Connection, Accounts and Settlement booking.
Under Connection, choose the bank account under Payout lands in. If you have several active bank accounts and no choice, Payfriend does not match the bank line.
Under Accounts, choose Receiving account, Fee account, Revenue account and VAT code, and click Save accounts. No voucher is created without these accounts.
Changes apply from the next booking. Vouchers already booked are not changed.
Cutover date
If you have already booked Stripe manually, set a Cutover date under Settlement booking. Payouts before that date are fetched as history and are not booked in Payfriend. Before that date your accounting is the source of truth. Here you also choose how far back history is fetched: 90, 180 or 365 days.
After connecting
Open Bank → Settlements, choose Needs you, and book the first payout yourself.
If the voucher goes through cleanly, you can switch on Auto-book under Settlement booking. It only works when the payout nets to zero and all accounts are set. If you use e-conomic, you can choose Stop in draft instead.
The bank line is matched once the voucher is booked, if the amount equals the payout and the line is on the bank account you chose.
You disconnect Stripe under Settings → Connections. Payouts already fetched stay in Payfriend.
Check that it worked
Stripe shows as Connected with read access
Receiving, fee, revenue and VAT code are set under Accounts
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. Payfriend fetches new payouts automatically |
Status Accounts missing | Accounts or VAT code are missing | Complete Settings → Settlements → Accounts |
Connection rejected or revoked | Access was revoked in Stripe, or you declined it | Click Renew access or connect again under Settings → Connections |
Old payouts visible but cannot be booked | They are before the cutover date (status Before cutover) | Check the date under Settlement booking |
The bank line is not matched | Several active bank accounts and none chosen, or the amount differs | Choose Payout lands in, or link the bank line to the payout yourself |
See also
Didn't find an answer? Message us via in-app chat, or use Contact. We reply on business days.