Verify your users’ identity documents
Create sessions and collect identity documents.
This guide explains how to use Stripe Identity to securely collect and verify identity documents.
Before you begin
- Activate your account.
- Fill out your Stripe Identity application.
- (Optional) Customize your brand settings on the branding settings page.
The Stripe Dashboard is the most common way to create one-off verifications but you can automate this process if you integrate with the API. Here’s what you’ll do:
- Create a VerificationSession with Dashboard.
- Share the verification link with you user.
- View verification results in Dashboard.
Create a VerificationSessionDashboard
A VerificationSession is the programmatic representation of the verification. It contains details about the type of verification, such as what check to perform and exposes the verified outputs.
To create a VerificationSession in the Stripe Dashboard:
- Navigate to the Create a session page.
- Select Document check.
- Click Create.
Share the verification link with your userDashboard
- Click Copy verification link.
- Share the copied URL with your user.
Verification links expire after 48 hours after creation and are single-use. Only share the link with the user you want to verify. We don’t recommend sending verification links in emails or text messages.
View verification resultsDashboard
Document checks are typically completed as soon as the user redirects back to your site and you can retrieve the result from the API immediately. In some rare cases, the document verification isn’t ready yet and must continue asynchronously. In these cases, you’re notified through webhooks when the verification result is ready. After the processing completes, the VerificationSession status changes from processing to verified.
Use the Dashboard to view all your verifications, inspect collected data, and understand verification failures.