Skip to main content

Verify webhook notifications

Once you've configured your webhook receiver, you'll be notified of events that occur during the ID Document 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
id_document_verification_quality_checks_in_progressquality_checks_in_progressYou submitted the document and Checkout.com perfoms the quality checks.
id_document_verification_checks_in_progresschecks_in_progressCheckout.com has performed the quality checks and processes the security checks.
id_document_verification_completedapprovedThe applicant's document has been approved
id_document_verification_completeddeclinedThe applicant's document has been declined
id_document_verification_quality_checks_abortedretry_requiredThe quality of the the images does not allow us to perform the checks, create a new attempt with other images
id_document_verification_checks_inconclusiveretry_requiredResult is inconclusive, create a new attempt with other images

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.