Onboard sellers and provision balance accounts on Adyen for Platforms with KYC verification

Steps

1. Create a legal entity for the seller via POST /legalEntities with type=individual (for sole traders) or type=organization (for businesses), providing required identification fields — the legal entity ID is the root resource for all subsequent KYC.
2. Create an account holder via POST /accountHolders specifying legalEntityId and requesting the capabilities you need (e.g., receivePayments, receiveFromPlatformPayments, sendToTransferInstrument) — capability status starts as inactive pending KYC.
3. Create a balance account and link it to the account holder via POST /balanceAccounts with accountHolderId; this is where split payment proceeds will land.
4. Generate a hosted onboarding link via POST /accountHolders/{id}/onboardingLinks and redirect the seller to this URL to complete KYC; Adyen collects documents and verifies identity asynchronously.
5. Subscribe to the balancePlatform.accountHolder.updated webhook and check the capabilities object in the payload — when sendToTransferInstrument transitions to active (verificationStatus=valid), the seller's balance account is eligible to receive payouts.
6. Add the seller's verified bank account as a transfer instrument via POST /transferInstruments with type=bankAccount and link it to the account holder; this enables payout sweeps to the seller's external bank.