Overview
Payouts define how funds are transferred from a connected account to its external destination.
By default, any funds collected on behalf of a connected account accumulate in that account’s balance and are paid out on a rolling basis.
Payout lifecycle
Funds follow a standard lifecycle:
Payments are processed on behalf of the connected account and added to its balance.
After processing and settlement delays, funds move to the available balance.
Available funds are transferred to the connected account’s external payout destination.
Payout management configurations
Platforms are responsible for managing payouts for connected accounts that do not have access to a hosted dashboard.
This includes:
- Managing external payout accounts (bank accounts)
External payout accounts
Each connected account must have at least one external accounts to receive payouts.
These accounts represent the destination where funds are transferred.
Supported settlement currencies
Payouts can be made in supported settlement currencies.
Supported currencies include:
- DKK
- SEK
- NOK
- GBP
- EUR
- USD
- CHF
- CZK
- HUF
- PLN
- RON
The availability of payout currencies may depend on the country of the connected account and the configured capabilities.
Track and reconcile payouts
Use your API key to list payouts or retrieve a payout. For a connected account, include its ID in the Paypercut-Account header. The API returns payouts for the selected account in the current live or test mode.
- Filter the list by currency or status. If
has_moreistrue, passlast_keywith the same filters to get the next page. - Add
expand[]=destinationto see the masked bank account details recorded for the payout. These details describe where the payout was sent, even if the account changes its payout destination later. - Interpret
amountusingcurrency.scale. For example, an amount of125000with currencyEURand scale2means €1,250.00. - Listen for
payout.paidto record when a payout is marked paid. Use the payout ID to generate a report showing which amounts contributed to the payout.
Platform responsibilities
When managing payouts, your platform is responsible for:
- Ensuring a valid external account is attached
- Handling onboarding requirements related to payouts
- Providing visibility to connected accounts
Related APIs
- Accounts API
- External Accounts API
- Webhooks (for payout and account updates)

