Configure Adyen for Platforms split transactions and automated seller payout sweeps

domain: docs.adyen.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create a split configuration profile in Adyen Customer Area (Accounts & balances > Split configurations) defining split logic: a commission amount or percentage for your platform, a remainder to the seller's balance account, and optionally a separate surcharge or tip split.
  2. Link the split configuration to your Adyen store or associate it at payment-request time by passing a splits array in the /payments or /sessions request body, specifying each split's type (BalanceAccount, Commission, Remainder), amount or percentage, and the target balance account ID.
  3. To automate seller payouts, configure a sweep on each seller's balance account via POST /balanceAccounts/{balanceAccountId}/sweeps: set schedule (daily, weekly, or cron expression), the target transfer instrument (verified bank account), and sweep type (PUSH to send funds out).
  4. Handle the balancePlatform.accountHolder.updated webhook to detect when an account holder's capabilities change (e.g., payouts become ACTIVE after KYC), which is the trigger to enable live payout sweeps for that seller.
  5. Monitor the Balance Platform Payout Report (available in Customer Area > Reports) to reconcile settled amounts per balance account against your internal order records.
  6. For on-demand payouts bypassing the sweep schedule, POST /transfers with type=bankTransfer to move a specific amount from a seller's balance account to their transfer instrument immediately.

Known gotchas

Related routes

Configure Adyen for Platforms balance account sweeps (automatic fund disbursement) including transfer instruments and sweep scheduling
docs.adyen.com · 6 steps · unrated
Orchestrate an Adyen for Platforms payout split and reconcile sub-merchant settlement
docs.adyen.com · 6 steps · unrated
Onboard a seller on Adyen for Platforms: create an account holder, provision a balance account, and configure a payout sweep
docs.adyen.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans