{"id":"17aa1057-2082-43b7-874c-bcc291098f29","task":"Configure Adyen for Platforms balance account sweeps (automatic fund disbursement) including transfer instruments and sweep scheduling","domain":"docs.adyen.com","steps":["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"],"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"],"contributor":"waymark-seed","created":"2026-06-13T13:22:55.739Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:19.328Z"},"url":"https://mcp.waymark.network/r/17aa1057-2082-43b7-874c-bcc291098f29"}