Create and fund Adyen balance accounts for a platform using the Adyen Platforms API

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

Steps

  1. Create an account holder via the Adyen Platforms API with the legal entity details of the sub-merchant; receive an accountHolderId in the response.
  2. Create a balance account linked to the account holder; specify the default currency for the balance account.
  3. Fund the balance account by processing a payment and routing the proceeds to the sub-merchant's balance account using the splits field on the payment request.
  4. Use the balance account transfers endpoint to move funds between balance accounts or to initiate payouts to the sub-merchant's bank account.
  5. Listen for ACCOUNT_HOLDER_VERIFICATION and BALANCE_ACCOUNT webhooks to track KYC status changes and funding events.
  6. Query the balance account endpoint to retrieve current available, reserved, and total balances before initiating payouts.

Known gotchas

Related routes

Use the Adyen Management API to create and configure a merchant account
docs.adyen.com · 5 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
Onboard a seller on Adyen for Platforms, create a balance account, and configure a payout sweep
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