Ensure the AccountHolder's sendToTransferInstrument capability is in Valid status before configuring sweeps — invalid capability status will cause sweep execution to fail
Create a Sweep on the BalanceAccount via POST /balanceaccounts/{balanceAccountId}/sweeps with schedule (daily, weekly, or cron-based schedule.cronExpression), currency, and counterparty.transferInstrumentId
Set sweep.type to pull (to fund the balance from the transfer instrument) or push (to disburse funds from the balance account to the transfer instrument); for seller payouts use push
Optionally configure triggerAmount to only sweep when the balance exceeds a threshold, preventing micro-payouts; set a targetAmount if you want to retain a buffer in the balance account after the sweep
Retrieve all sweeps for a balance account via GET /balanceaccounts/{id}/sweeps and update sweep parameters via PATCH /balanceaccounts/{id}/sweeps/{sweepId}
Monitor sweep execution via webhook events (balancePlatform.transfer.created with category=bank) that fire when Adyen processes the sweep transfer — use these to update your internal ledger
Known gotchas
Sweep execution depends on the transfer instrument's bank being reachable on the scheduled date — public holidays or banking system outages in the destination country may delay or skip a scheduled sweep; build retry and monitoring logic accordingly
If a balance account has insufficient funds for a full sweep when using a targetAmount retention, the sweep will transfer only the available balance above the target — the resulting transfer may be smaller than expected; verify sweep amounts in the webhook payload
Cron-based sweep schedules use Adyen's server timezone — verify the cron expression corresponds to the intended local time for your sellers to avoid unexpected payout timing
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp