Verification Flows

Use Verification Flows to configure your verification preferences, deploy no-code verifications, and manage link expiration. You can access each configuration option available in the Identity API, allowing you to select your desired verification type and modify the verification process accordingly.

Create Flows

To set up your Identity integration, create a Verification Flow:

1. Navigate to the Verification Flow page, then click Create Flow.
2. Select a type from the Verification type dropdown.
3. Enter a name in the Flow title field.
4. Select the options that you want to use.
5. Optionally, provide a return URL.
6. Click Save.

Manage Flows

The Verification Flows page displays all the Verification Flows that you create. You can create distinct Flows for different use-cases, such as:

• Marketing campaigns
• High-value versus low-value transactions
• Known high-risk users versus trusted users
• Any other relevant use case

After you create a Verification Flow, use the details page to:

• View details and edit the Flow
• View a list of all the Verification Sessions controlled by the Flow
• Activate or deactivate the static link associated to the Flow

Update Flows

Use Verification Flows to deploy configuration updates to production (for example, you can edit the Verification Flow details in the Dashboard to add or remove a selfie check from a live document Verification Flow). Any future verifications you create with this Flow automatically adopt the updated configuration, so make sure to apply changes cautiously.

Use Flows to verify users

After you have created a Verification Flow, you have two options to initiate an identity verification using that Flow’s configuration.

curl https://api.stripe.com/v1/identity/verification_sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d verification_flow=
{{VERIFICATION_FLOW_ID}}

curl https://api.stripe.com/v1/identity/verification_sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d verification_flow=
{{VERIFICATION_FLOW_ID}} \
  -d "provided_details[phone]"=5555551212 \
  --data-urlencode "provided_details[email]"="user@domain.com" \
  -d client_reference_id=reference-token