ID Document Verification webhooks
Beta

Last updated: September 24, 2025

The ID Document Verification solution returns webhooks for the following types of event:

Successful verification:

id_document_verification_created – Occurs when you successfully create the verification
id_document_verification_started – Occurs when Checkout.com has confirmed image quality and starts checking authenticity
id_document_verification_checks_completed – Occurs when Checkout.com has successfully processed the verification
id_document_verification_report_created – Occurs when the verification report is available

Unsuccessful verification:

id_document_verification_closed - Occurs when you forcibly close the verification
id_document_verification_checks_inconclusive – Occurs when the applicant did not provide the images required to process the verification

After the verification:

id_document_verification_anonymized – Occurs when the personal data is removed from a verification
id_document_verification_audit_completed – Occurs when the verification is audited and the status has likely been updated


1{
2  "id": "evt_lecalzfkynuengzghfkpta7hya",
3  "type": "id_document_verification_created",
4  "version": "1.2.0",
5  "created_on": "2025-09-11T13:47:48.977127Z",
6  "data": {
7    "applicant_id": "aplt_01k4wge46qg8f3ax6gtbcb3kn3",
8    "external_applicant_id": "eaplt_10000000000000000000000000",
9    "status": "created",
10    "id_document_verification_id": "iddv_01k4wggjsjsgq9exgfmq5qqd1z",
11    "response_codes": [],
12    "user_journey_id": "usj_01jrcvqv7w0ex6mrqcjwdpzn31"
13  },
14  "_links": {
15    "self": {
16      "href": "https://flow.cko-qa.ckotech.co/workflows/events/evt_lecalzfkynuengzghfkpta7hya"
17    },
18    "subject": {
19      "href": "https://flow.cko-qa.ckotech.co/workflows/events/subject/iddv_01k4wggjsjsgq9exgfmq5qqd1z"
20    }
21  }
22}


1{
2  "id": "evt_zew2glhpn5be7bhq636azhmtde",
3  "type": "id_document_verification_started",
4  "version": "1.2.0",
5  "created_on": "2025-09-11T13:50:49.861077Z",
6  "data": {
7    "applicant_id": "aplt_01k4wge46qg8f3ax6gtbcb3kn3",
8    "external_applicant_id": "eaplt_10000000000000000000000000",
9    "status": "checks_in_progress",
10    "id_document_verification_id": "iddv_01k4wggjsjsgq9exgfmq5qqd1z",
11    "response_codes": [],
12    "user_journey_id": "usj_01jrcvqv7w0ex6mrqcjwdpzn31"
13  },
14  "_links": {
15    "self": {
16      "href": "https://flow.cko-qa.ckotech.co/workflows/events/evt_zew2glhpn5be7bhq636azhmtde"
17    },
18    "subject": {
19      "href": "https://flow.cko-qa.ckotech.co/workflows/events/subject/iddv_01k4wggjsjsgq9exgfmq5qqd1z"
20    }
21  }
22}


1{
2  "id": "evt_frkcdamnxvhuvgm6k562wdpla4",
3  "type": "id_document_verification_checks_completed",
4  "version": "1.2.0",
5  "created_on": "2025-09-11T13:51:04.744393Z",
6  "data": {
7    "applicant_id": "aplt_01k4wge46qg8f3ax6gtbcb3kn3",
8    "external_applicant_id": "eaplt_10000000000000000000000000",
9    "status": "approved",
10    "id_document_verification_id": "iddv_01k4wggjsjsgq9exgfmq5qqd1z",
11    "response_codes": [
12      {
13        "code": 10000,
14        "summary": "approved"
15      }
16    ],
17    "user_journey_id": "usj_01jrcvqv7w0ex6mrqcjwdpzn31"
18  },
19  "_links": {
20    "self": {
21      "href": "https://flow.cko-qa.ckotech.co/workflows/events/evt_frkcdamnxvhuvgm6k562wdpla4"
22    },
23    "subject": {
24      "href": "https://flow.cko-qa.ckotech.co/workflows/events/subject/iddv_01k4wggjsjsgq9exgfmq5qqd1z"
25    }
26  }
27}


1{
2  "id": "evt_rpbk7mcr7weufanr27xgjmye4q",
3  "type": "id_document_verification_report_created",
4  "version": "1.2.0",
5  "created_on": "2025-09-11T13:51:07.448958Z",
6  "data": {
7    "applicant_id": "aplt_01k4wge46qg8f3ax6gtbcb3kn3",
8    "external_applicant_id": "eaplt_10000000000000000000000000",
9    "status": "approved",
10    "id_document_verification_id": "iddv_01k4wggjsjsgq9exgfmq5qqd1z",
11    "response_codes": [
12      {
13        "code": 10000,
14        "summary": "approved"
15      }
16    ],
17    "user_journey_id": "usj_01jrcvqv7w0ex6mrqcjwdpzn31"
18  },
19  "_links": {
20    "self": {
21      "href": "https://flow.cko-qa.ckotech.co/workflows/events/evt_rpbk7mcr7weufanr27xgjmye4q"
22    },
23    "subject": {
24      "href": "https://flow.cko-qa.ckotech.co/workflows/events/subject/iddv_01k4wggjsjsgq9exgfmq5qqd1z"
25    }
26  }
27}


1{
2  "id": "evt_mmajxqu4hr3ulfy5wu4fdtrphe",
3  "type": "id_document_verification_closed",
4  "version": "1.2.0",
5  "created_on": "2025-09-11T14:12:37.377678Z",
6  "data": {
7    "applicant_id": "aplt_01k4wge46qg8f3ax6gtbcb3kn3",
8    "external_applicant_id": "eaplt_10000000000000000000000000",
9    "status": "inconclusive",
10    "id_document_verification_id": "iddv_01k4whw7x0m7zrprdbdy490tet",
11    "response_codes": [
12      {
13        "code": 61301,
14        "summary": "document_video_blurry"
15      }
16    ],
17    "user_journey_id": "usj_01jrcvqv7w0ex6mrqcjwdpzn31"
18  },
19  "_links": {
20    "self": {
21      "href": "https://flow.cko-qa.ckotech.co/workflows/events/evt_mmajxqu4hr3ulfy5wu4fdtrphe"
22    },
23    "subject": {
24      "href": "https://flow.cko-qa.ckotech.co/workflows/events/subject/iddv_01k4whw7x0m7zrprdbdy490tet"
25    }
26  }
27}


1{
2  "id": "evt_y2zvzhfx7s6excflwez7g7ga3i",
3  "type": "id_document_verification_checks_inconclusive",
4  "version": "1.2.0",
5  "created_on": "2025-09-12T08:31:33.50375Z",
6  "data": {
7    "applicant_id": "aplt_01k4yfngkw39cf5ztmmgn911wz",
8    "external_applicant_id": "eaplt_10000000000000000000000000",
9    "status": "retry_required",
10    "id_document_verification_id": "iddv_01k4ygstgqxypp7gb2h3jpffcx",
11    "response_codes": [
12      {
13        "code": 61301,
14        "summary": "document_video_blurry"
15      }
16    ],
17    "user_journey_id": "usj_01jrcvqv7w0ex6mrqcjwdpzn31"
18  },
19  "_links": {
20    "self": {
21      "href": "https://flow.cko-qa.ckotech.co/workflows/events/evt_y2zvzhfx7s6excflwez7g7ga3i"
22    },
23    "subject": {
24      "href": "https://flow.cko-qa.ckotech.co/workflows/events/subject/iddv_01k4ygstgqxypp7gb2h3jpffcx"
25    }
26  }
27}


1{
2  "id":"evt_t555mt5y33vutlwblmqibdkg2e",
3  "type":"id_document_verification_anonymized",
4  "version":"1.2.0",
5  "created_on":"2025-09-19T10:15:26.993307Z",
6  "data":{
7    "applicant_id":"aplt_01k4yfngkw39cf5ztmmgn911wz",
8    "external_applicant_id":"eaplt_10000000000000000000000000",
9    "status":"inconclusive",
10    "id_document_verification_id":"iddv_01k5gqgnjcye859kkqst0484xr",
11    "response_codes":[
12      {
13        "code":64001,
14        "summary":"forcibly_closed"
15      }
16    ],
17    "user_journey_id":"usj_01jrcvqv7w0ex6mrqcjwdpzn31"
18  },
19  "_links":{
20    "self":{
21      "href":"https://flow.cko-qa.ckotech.co/workflows/events/evt_t555mt5y33vutlwblmqibdkg2e"
22    },
23    "subject":{
24      "href":"https://flow.cko-qa.ckotech.co/workflows/events/subject/iddv_01k5gqgnjcye859kkqst0484xr"
25    }
26  }
27}


1{
2  "id":"evt_t555mt5y33vutlwblmqibdkg2e",
3  "type":"id_document_verification_audit_completed",
4  "version":"1.2.0",
5  "created_on":"2025-09-19T10:15:26.993307Z",
6  "data":{
7    "applicant_id":"aplt_01k4yfngkw39cf5ztmmgn911wz",
8    "external_applicant_id":"eaplt_10000000000000000000000000",
9    "status":"approved",
10    "id_document_verification_id":"iddv_01k5gqgnjcye859kkqst0484xr",
11    "response_codes":[
12      {
13        "code":10000,
14        "summary":"approved"
15      }
16    ],
17    "user_journey_id":"usj_01jrcvqv7w0ex6mrqcjwdpzn31"
18  },
19  "_links":{
20    "self":{
21      "href":"https://flow.cko-qa.ckotech.co/workflows/events/evt_t555mt5y33vutlwblmqibdkg2e"
22    },
23    "subject":{
24      "href":"https://flow.cko-qa.ckotech.co/workflows/events/subject/iddv_01k5gqgnjcye859kkqst0484xr"
25    }
26  }
27}

Field name	Description
`id` string	The event's unique identifier, prefixed with `evt_`.
`type` string	The event type.
`version` string	The webhook version.
`created_on` date-time	The date and time when the event occurred, in UTC. Standard – ISO 8601 code Format – `yyyy-mm-ddThh:mm:ss.sss`
`data` object	The details of the webhook message.
`data.` `applicant_id` string	The applicant's unique identifier, prefixed with `aplt_`.
`data.` `external_applicant_id` string	Your unique identifier for the applicant, provided in the Create an applicant request. This is prefixed with `ealpt_`.
`data.` `status` string	The ID document verification status.
`data.` `id_document_verification_id` string	The ID document verification's unique identifier, prefixed with `iddv_`.
`data.` `response_codes` object	The details of the response code that provides more information about the status. This is returned for the following events: `id_document_verification_anonymized` `id_document_verification_audit_completed` `id_document_verification_checks_completed` `id_document_verification_checks_inconclusive` `id_document_verification_closed` `id_document_verification_report_created`
`data.` `response_codes.` `code` number	The response code.
`data.` `response_codes.` `summary` string	The summary that explains the response code.
`data.` `user_journey_id` string	Your ID Document Verification configuration ID, prefixed with `usj_`.
`_links.self.href` string	The URL to the event.
`subject..href` string	The URL to the ID Document Verification resource.

ID Document Verification webhooks
Beta

Example webhooks

Successful verification

Unsuccessful verification

After the verification

Webhook fields