List Merchant Settlements
GET/api/partner/v1/merchants/:ref/settlements
Lists a merchant's settlements (amounts paid out to the merchant's bank account and their state), newest first. Requires scope account:read and an active merchant delegation covering that scope.
Pagination: cursor-based. Returns { data, next_cursor }; accepts only per_page (max 200, default 50) and cursor.
Each row is { id, state, net, fee, gross, currency, created_at, exported_at }. The net, fee and gross amounts are PLN decimal strings (major units).
Request
Responses
- 200
- 401
- 403
- 404
Page of settlements.
Missing or invalid partner key.
The partner key lacks the account:read scope, the merchant has not authorized this operation, or dpay Connect is currently unavailable.
No merchant with this ref belongs to your partner account.