# Stripe Identity: ID Verification

> Plugin page: <https://bubble.io/plugin/stripe-identity-id-verification-1726001234440x741658299475427300>

## Description

The Stripe Identity plugin makes it super easy to verify users' documents, like SSNs and driver's licenses. You won't need to do much setup either—the plugin handles the integration between your app and your Stripe account.

The verification flow:

1. Add a verification button to your webpage that redirects to Stripe Identity.
2. Display a confirmation page on identity document submission.
3. Handle verification results.

## Features

* All the methods for handling id verification through Stripe
* Verify the authenticity of ID documents from more than 120 countries
* Match photo IDs with selfies, and validate Social Security numbers (SSNs)

## How to Use

Stripe Identity plugin features a set of actions that allow handle user ID verification in the Bubble application without any additional efforts for setting it up.

1. **Find and install the plugin**: Search for the plugin in the plugin list and install it in your application.

<figure><img src="/files/LuqZ8nG0NM7iCiU8OMWQ" alt=""><figcaption></figcaption></figure>

2. Add plugin's actions/data calls to the workflows where needed.&#x20;

Actions:

### Create a Verification Session

<figure><img src="/files/DOzfIR9E7L2fW6roVmXL" alt=""><figcaption></figcaption></figure>

A VerificationSession guides you through the process of collecting and verifying the identities of your users.  Only create one VerificationSession for each verification in your system.

A VerificationSession transitions through [multiple statuses](https://docs.stripe.com/identity/how-sessions-work) throughout its lifetime as it progresses through the verification flow. The VerificationSession contains the user’s verified data after verification checks are complete.

**Settings:**

* Metadata

Allows to pass through additional information to Stripe in key/value pairs.

* Type&#x20;

[Document](https://docs.stripe.com/identity/verification-checks?type=document) checks verify the authenticity for most government issued documents (national IDs, driver’s licenses and passports).

[Id number](https://docs.stripe.com/identity/verification-checks?type=id-number) checks provide a way to verify a user’s name, date of birth, and national ID number. Stripe uses a combination of third-party data sources such as credit agencies or bureaus, utility or government-issued databases, and others to verify the provided ID number.

* Allow driving license
* Allow ID card
* Allow passport
* Require ID number

Collect an ID number and perform an ID number check with the document’s extracted name and date of birth.

* Require live capture

Disable image uploads, identity document images have to be captured using the device’s camera.

* Require matching selfie&#x20;

Capture a face image and perform a selfie check comparing a photo ID and a picture of your user’s face.

* User email

Email of the user being verified

* User phone

Phone number of user being verified&#x20;

* Terminate workflow in case of error

If you don't want to terminate a workflow when any errors occur leave this checkbox off. In this case an error message will be available in the "error\_message" result field

### Update a Verification Session

<figure><img src="/files/VPEqtvGUEA2ZAoLUvp1S" alt=""><figcaption></figcaption></figure>

When the session status is `requires_input`, you can use this method to update the verification check and options. For description of parameters, see [here](#create-a-verification-session).&#x20;

### Retrieve a Verification Session

<figure><img src="/files/npJr1zTkELOuoRvvEhet" alt=""><figcaption></figcaption></figure>

Retrieves the details of a VerificationSession that was previously created.

When the session status is `requires_input`, you can use this method to retrieve a valid `url` to allow re-submission.

### Cancel a Verification Session

<figure><img src="/files/yWXANOAkyKXLKKZsVOW0" alt=""><figcaption></figcaption></figure>

A VerificationSession object can be canceled when it is in `requires_input` [status](https://docs.stripe.com/identity/how-sessions-work).

Once canceled, future submission attempts are disabled. This cannot be undone

### Redact a Verification Session

<figure><img src="/files/nAfQ1iNxXIuX9z2qgVjG" alt=""><figcaption></figcaption></figure>

Redact a VerificationSession to remove all collected information from Stripe. This will redact the VerificationSession and all objects related to it, including VerificationReports, Events, request logs, etc.

A VerificationSession object can be redacted when it is in `requires_input` or `verified` [status](https://docs.stripe.com/identity/how-sessions-work). Redacting a VerificationSession in `requires_action` state will automatically cancel it.

The redaction process may take up to four days.&#x20;

Redacted objects cannot be updated or used for any purpose.

Data calls:&#x20;

* Retrieve a Verification Session (by id)
* Retrieve a Verification Session List
* Retrieve a Verification Session Report (by id)

A VerificationReport is the result of an attempt to collect and verify data from a user. The collection of verification checks performed is determined from the `type` and `options` parameters used.&#x20;

* Retrieve a Verification Session Report List


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thesimplelabs.com/plugins/stripe-identity-id-verification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
