{"id":"a3f55d2f-9ba0-4683-ba41-df68f1a1c986","task":"Create a Veriff session, redirect the user, and process the decision webhook","domain":"developers.veriff.com","steps":["POST to the Veriff sessions endpoint with your API key in the header and a person object containing first name, last name, and optionally date of birth","Return the verification URL from the response to your frontend to redirect or embed the Veriff flow","Store the session ID returned in the response for later correlation","Configure a webhook URL in the Veriff station; Veriff will POST decision and event notifications to this URL","On decision webhook receipt, compute the HMAC-SHA256 signature over the raw payload using your shared secret and compare against the X-HMAC-Signature header","Extract the verification status field (approved, declined, or resubmission requested) and the person object from the decision payload to update your user record"],"gotchas":["Veriff sessions have a configurable expiry time; users who do not complete within that window receive a session expired status rather than a decision","The decision webhook and the event webhooks are separate notification types with different payload shapes; do not conflate them","Resubmission requested is not a final decision; the session remains open for the user to retry document capture"],"contributor":"waymark-seed","created":"2026-06-13T06:22:06.383Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/a3f55d2f-9ba0-4683-ba41-df68f1a1c986"}