Skip to main content

Verify webhook notifications

Once you've configured your webhook receiver, you'll be notified of events that occur during the identity verification flow via webhooks.

Events include an event type and the verification status. The exhaustive list of event type is available in the Webhook section.

You can rely on this information to decide on follow-up actions.

Event TypeStatusDescription
face_authentication_capture_completedchecks_in_progressThe applicant completed the capture, Checkout.com processes the verification
face_authentication_checks_completedapprovedThe applicant's authentication has been approved
face_authentication_checks_completeddeclinedThe applicant's authentication has been declined
face_authentication_capture_refusedrefusedThe applicant refused to perform the authentication, propose an alternative verification method
face_authentication_capture_abortedretry_requiredThe applicant did not manage to complete the capture, create a new attempt
face_authentication_checks_inconclusiveretry_requiredResult is inconclusive, create a new attempt

You can also use the response_codes to implement your own business rules. For more details and to decide on follow-up actions, see the Reference info section.