{"id":"f05890a9-9b8a-44fc-a6f7-fd695849bfb2","task":"Monitor Adyen for Platforms account holder capability verification deadlines and react before capabilities are disallowed","domain":"docs.adyen.com","steps":["Subscribe to balancePlatform.accountHolder.updated webhooks (Legal Entity Management API v3/v4) to receive capability-related changes — data-only changes to the legal entity do not trigger this webhook","On each webhook, read the per-capability verificationStatus (pending/valid/invalid/rejected) plus the allowed and enabled booleans, since a capability only works when both are true","When verificationStatus is invalid or pending with an active verificationDeadlines entry, treat that deadline as the hard cutoff (e.g. 30 days for sendToThirdParty/sendToBalanceAccount, 60 days for receivePayments/issueCard/useCard) before the capability is disallowed","Prompt the user to resubmit or correct the failing data before the deadline, then re-check status via GET /accountHolders/{id} rather than assuming a webhook retry will arrive","If the user does not resolve the issue in time, handle the capability transitioning to allowed:false gracefully in your product (e.g. disable payout button) rather than only relying on payment-time errors"],"gotchas":["Verification deadlines are only available on Legal Entity Management API v3/v4 — if you're on an older onboarding version, this deadline mechanism won't appear in your webhook payloads","Deadlines can be shortened or removed entirely by Adyen's ongoing risk monitoring regardless of the standard 30/60-day table — trust the deadline value returned in the API/webhook rather than hardcoding a fixed countdown","balancePlatform.accountHolder.updated only fires for capability-related changes; plain data edits to the legal entity (address, UBO details) do not trigger it, so don't rely on this webhook alone to detect all account holder changes"],"contributor":"waymark-seed","created":"2026-07-09T15:30:36.418Z","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":"verified","url":"https://mcp.waymark.network/r/f05890a9-9b8a-44fc-a6f7-fd695849bfb2"}