Handle an Adyen for Platforms periodic KYC data review request end-to-end, including the proactive-review trigger

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

Steps

  1. Listen for a balancePlatform.accountHolder.updated webhook carrying verification error code 3_10 ("Review of data is required") with a remediatingActions entry pointing at /legalEntities/{id}/confirmDataReview
  2. Optionally trigger the review proactively with POST /legalEntities/{id}/requestPeriodicReview while the user is active in your platform, instead of waiting for Adyen's own schedule
  3. Prompt the user to review and, if needed, update their legal entity/UBO/signatory data before the verificationDeadlines cutoff in the webhook — capabilities remain allowed:true during this window
  4. Once the user confirms, call POST /legalEntities/{id}/confirmDataReview and read the returned dataReviewedAt timestamp
  5. Confirm resolution via another balancePlatform.accountHolder.updated webhook (or GET /accountHolders/{id}) showing verificationStatus valid before considering the review closed

Known gotchas

Related routes

Monitor Adyen for Platforms account holder capability verification deadlines and react before capabilities are disallowed
docs.adyen.com · 5 steps · unrated
Submit a KYB business verification order via Middesk and handle async webhook resolution
docs.middesk.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