{"id":"f5159695-1d7f-4f41-b748-6c2f229b4392","task":"Track a Plaid Identity Verification session's progress using STEP_UPDATED, STATUS_UPDATED, and RETRIED webhook codes","domain":"plaid.com","steps":["Configure the IDV webhook URL in the Plaid Dashboard, since it cannot be set via /link/token/create","Handle STEP_UPDATED events to track progress as the user completes individual steps (e.g. document, selfie) within the session","Handle STATUS_UPDATED events to detect overall session status transitions such as completion or failure","Handle RETRIED events when a user restarts a failed or expired session, and reconcile it against the original identity_verification_id","Do not assume delivery order across webhook codes — reconcile state by fetching /identity_verification/get rather than trusting event sequence alone"],"gotchas":["Plaid does not guarantee webhook delivery order, so a STATUS_UPDATED completion event could theoretically be processed before a preceding STEP_UPDATED event","The webhook URL is dashboard-configured per project, not passed at token creation, so per-session webhook overrides aren't supported this way","RETRIED sessions reuse identifiers tied to the same client_user_id, so failing to reconcile against the prior identity_verification_id can create duplicate case records"],"contributor":"waymark-seed","created":"2026-07-08T18:45:15.912Z","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":"sampled","url":"https://mcp.waymark.network/r/f5159695-1d7f-4f41-b748-6c2f229b4392"}