Identity Verification testing
Beta
Last updated: August 13, 2025
You can test the following Identity Verification scenarios:
- Successful verification
- Successful on retry after capture abandoned
- Successful on retry after checks inconclusive
- Declined verification
- Declined on retry after capture abandoned
- Declined on retry after checks inconclusive
Set up your webhook receiver to test real-time webhooks for every event in each scenario.
Subscribe to the following webhooks:
- identity_verification_created
- identity_verification_opened
- identity_verification_started
- identity_verification_capture_completed
- identity_verification_checks_completed
Call the Create an applicant endpoint, setting the external_applicant_id field to eaplt_10000000000000000000000000.
post
https://api.sandbox.checkout.com/applicants
Call the Create an identity verification endpoint, setting the applicant_id field to the id value returned in the Create applicant response.
For example, the id returned here is aplt_tkoi5db4hryu5cei5vwoabr7we.
post
https://identity-verification.sandbox.checkout.com/identity-verifications
The response returns the verification ID, prefixed with idv_.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr7.
post
https://api.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
You receive an identity_verification_checks_completed webhook with the response code 10000.
Call the Retrieve an identity verification endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
get
https://identity-verification.sandbox.checkout.com/identity-verifications/{identity_verification_id}
Subscribe to the following webhooks for the first attempt:
- identity_verification_created
- identity_verification_opened
- identity_verification_started
- identity_verification_capture_aborted
Subscribe to the following webhooks for the final result:
- identity_verification_retry_requested
- identity_verification_started
- identity_verification_capture_completed
- identity_verification_checks_completed
Call the Create an applicant endpoint, setting the external_applicant_id field to eaplt_61XXXA10000000000000000000.
Replace 61XXX with the response code starting with 61 that you want to test.
For example, to test response code 61401, set the external_application_id to eaplt_61401A10000000000000000000.
post
https://api.sandbox.checkout.com/applicants
Call the Create an identity verification endpoint, setting the applicant_id field to the id value returned in the Create applicant response.
For example, the id returned here is aplt_tkoi5db4hryu5cei5vwoabr8hg.
post
https://identity-verification.sandbox.checkout.com/identity-verifications
The response returns the verification ID, prefixed with idv_.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr8hg.
post
https://api.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_capture_aborted first attempt webhook returns the response code starting with 61 that you provided for external_applicant_id.
When the identity_verification_capture_aborted webhook returns the retry_required status, create another attempt.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr8hg.
post
https://api.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_checks_completed final result webhook returns the response code 10000.
Optionally, you can retrieve the verification.
Subscribe to the following webhooks for the first attempt:
- identity_verification_created
- identity_verification_opened
- identity_verification_started
- identity_verification_capture_completed
- identity_verification_checks_inconclusive
Subscribe to the following webhooks for the final result:
- identity_verification_retry_requested
- identity_verification_started
- identity_verification_capture_completed
- identity_verification_checks_completed
Call the Create an applicant endpoint, setting the external_applicant_id field to eaplt_61XXXI10000000000000000000.
Replace 61XXX with a response code starting with 61 that you want to test.
For example, if you want to test response code 61310, set the external_application_id to eaplt_61310I10000000000000000000.
post
https://api.sandbox.checkout.com/applicants
Call the Create an identity verification endpoint, setting the applicant_id field to the id value returned in the Create applicant response.
For example, the id returned here is aplt_tkoi5db4hryu5cei5vwoabr7wf.
post
https://identity-verification.sandbox.checkout.com/identity-verifications
The response returns the verification ID, prefixed with idv_.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr7wf.
post
https://api.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_checks_inconclusive first attempt webhook returns the response code starting with 61 that you provided for external_applicant_id.
When the identity_verification_checks_inconclusive webhook returns the retry_required status, create another attempt.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr7wf.
post
https://api.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_checks_inconclusive final result webhook returns the response code starting with 61 that you provided for external_applicant_id.
Optionally, you can retrieve the verification.
Subscribe to the following webhooks:
- identity_verification_created
- identity_verification_opened
- identity_verification_started
- identity_verification_capture_completed
- identity_verification_checks_completed
Call the Create an applicant endpoint, setting the external_applicant_id field to eaplt_62XXX000000000000000000000.
Replace 62XXX with a response code starting with 62 that you want to test.
For example, if you want to test 62201, set the value to eaplt_62201000000000000000000000
post
https://api.sandbox.checkout.com/applicants
Call the Create an identity verification endpoint, setting the applicant_id field to the id value returned in the Create applicant response.
For example, the id returned here is aplt_tkoi5db4hryu5cei5vwoabr9fr.
post
https://identity-verification.sandbox.checkout.com/identity-verifications
The response returns the verification ID, prefixed with idv_.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr9fr.
post
https://identity-verification.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_checks_completed webhook returns the response code starting with 62 that you provided for external_applicant_id.
Optionally, you can retrieve the verification.
Subscribe to the following webhooks for the first attempt:
- identity_verification_created
- identity_verification_opened
- identity_verification_started
- identity_verification_capture_aborted
Subscribe to the following webhooks for the final result:
- identity_verification_retry_requested
- identity_verification_started
- identity_verification_capture_completed
- identity_verification_checks_completed
Call the Create an applicant endpoint, setting the external_applicant_id field to eaplt_61XXXA62XXX000000000000000. Replace:
61XXXwith a response code starting with61for the first attempt62XXXwith a response code starting with62for the final result
For example, to test response codes 61203 and 62103, set the value to eaplt_61203A62103000000000000000.
post
https://api.sandbox.checkout.com/applicants
Call the Create an identity verification endpoint, setting the applicant_id field to the id value returned in the Create applicant response.
For example, the id returned here is aplt_tkoi5db4hryu5cei5vwoabr1ab.
post
https://identity-verification.sandbox.checkout.com/identity-verifications
The response returns the verification ID, prefixed with idv_.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr1ab.
post
https://identity-verification.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_capture_aborted first attempt webhook returns the response code starting with 61 that you provided for external_applicant_id.
When the identity_verification_capture_aborted webhook returns the retry_required status, create another attempt.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr1ab.
post
https://identity-verification.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_checks_completed final result webhook returns the response code starting with 62 that you provided for external_applicant_id.
Optionally, you can retrieve the verification.
Subscribe to the following webhooks for the first attempt:
- identity_verification_created
- identity_verification_opened
- identity_verification_started
- identity_verification_capture_completed
- identity_verification_checks_inconclusive
Subscribe to the following webhooks for the final result:
- identity_verification_retry_requested
- identity_verification_started
- identity_verification_capture_completed
- identity_verification_checks_completed
Call the Create an applicant endpoint, setting the external_applicant_id field to eaplt_61XXXI62XXX000000000000000. Replace:
61XXXwith a response code starting with61for the first attempt62XXXwith a response code starting with62for the final result
For example, to test response codes 61203 and 62403, set the value to eaplt_61411I62403000000000000000.
post
`https://api.sandbox.checkout.com/applicants`
Call the Create an identity verification endpoint, setting the applicant_id field to the id value returned in the Create applicant response.
For example, the id returned here is aplt_tkoi5db4hryu5cei5vwoabr6ft.
post
https://identity-verification.sandbox.checkout.com/identity-verifications
The response returns the verification ID, prefixed with idv_.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr6ft.
post
https://identity-verification.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_checks_inconclusive first attempt webhook returns the response code starting with 61 that you provided for external_applicant_id.
When the identity_verification_checks_inconclusive webhook returns retry_required status, create another attempt.
Call the Create an attempt endpoint, and provide the verification ID as the {identity_verification_id} path parameter.
For example, the id returned here is idv_tkoi5db4hryu5cei5vwoabr6ft.
post
https://identity-verification.sandbox.checkout.com/identity-verifications/{identity_verification_id}/attempts
The identity_verification_checks_completed final result webhook returns the response code starting with 62 that you provided for external_applicant_id.
Optionally, you can retrieve the verification.