Updates a VerificationSession object.
When the session status is requires_
, you can use this method to update the verification check and options.
Parameters
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata
. - optionsobject
A set of options for the session’s verification checks.
- options.
documentobject Options that apply to the document check.
- options.
document. allowed_ typesarray of enums Array of strings of allowed identity document types. If the provided identity document isn’t one of the allowed types, the verification check will fail with a document_type_not_allowed error code.
Possible enum valuesdriving_
license Drivers license document type.
id_
card ID card document type.
passport
Passport document type.
- options.
document. require_ id_ numberboolean Collect an ID number and perform an ID number check with the document’s extracted name and date of birth.
- options.
document. require_ live_ captureboolean Disable image uploads, identity document images have to be captured using the device’s camera.
- options.
document. require_ matching_ selfieboolean Capture a face image and perform a selfie check comparing a photo ID and a picture of your user’s face. Learn more.
- provided_
detailsobject Details provided about the user being verified. These details may be shown to the user.
- provided_details.
emailstring Email of user being verified
- provided_details.
phonestring Phone number of user being verified
- typeenum
The type of verification check to be performed.
Possible enum valuesdocument
id_
number
Returns
Returns the updated VerificationSession object
{ "id": "vs_1NuN9WLkdIwHu7ix597AR9uz", "object": "identity.verification_session", "client_secret": "...", "created": 1695680478, "last_error": null, "last_verification_report": null, "livemode": false, "metadata": {}, "options": {}, "redaction": null, "status": "requires_input", "type": "id_number", "url": "..."}