{"id":"f8218756-44ec-4f57-9862-32e6236b752b","task":"Onboard sellers and provision balance accounts on Adyen for Platforms with KYC verification","domain":"docs.adyen.com","steps":["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.","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.","Create a balance account and link it to the account holder via POST /balanceAccounts with accountHolderId; this is where split payment proceeds will land.","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.","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.","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."],"gotchas":["Adyen's KYC is asynchronous — the onboarding link submission completes quickly but verification processing can take minutes to hours; do not assume capability activation at onboarding link completion; rely exclusively on the webhook event.","Different countries have different KYC document requirements managed by Adyen's verification rules; missing a country-specific required field causes the verification to enter a PENDING_INFORMATION state — use Adyen's KYC Insights dashboard (updated daily at 03:00 CET) to monitor stuck onboardings.","Legal entities and account holders are separate objects — deleting or modifying a legal entity does not automatically update linked account holders; maintain a mapping in your own database to manage the relationship."],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:44.112Z"},"url":"https://mcp.waymark.network/r/f8218756-44ec-4f57-9862-32e6236b752b"}