Sumsub Identity Verification

✅

Link to the plugin page:

https://zeroqode.com/plugin/sumsub-identity-verification-plugin-for-bubble-1685285248894x207713091705790800

Demo to preview the plugin:

✅

Live Demo:

https://zeroqode-demo-29.bubbleapps.io/sumsub_identity_verification?utm_source=docs&utm_medium=referral&utm_campaign=demo_link

✅

Bubble Editor:

https://bubble.io/page?version=live&id=zeroqode-demo-29&name=sumsub_identity_verification&tab=Design&type=page

Introduction

The Sumsub Identity Verification plugin enables Bubble developers to seamlessly integrate enterprise-grade identity verification and KYC workflows into their applications.

Powered by Sumsub, a globally trusted identity verification provider, this plugin allows you to verify users’ identities, documents, and personal information directly within your Bubble app - without building complex verification logic from scratch.

The plugin is designed to help fintechs, marketplaces, crypto platforms, regulated services, and any compliance-driven application meet KYC/AML requirements, reduce fraud, and improve user trust through a secure and automated verification process.

Key Features

Prerequisites

Before using the Sumsub Identity Verification plugin, ensure you have:

An active Sumsub account.

Access to the Sumsub Dashboard.

Your Sumsub API credentials:

App Token
Secret Key

A selected Sumsub environment:

Sandbox (testing)
Production (live)

How to Set Up

Step 1. Install the Plugin

Step 2. Generate App Token from the Sumsub Dashboard

Step 3. Configure API Keys & Settings

Step 4. Use the Plugin (Demonstration)

Step 5. Preview & Test

Plugin Data Calls

Getting Applicant Status – This Data Call retrieves the current verification status of an existing applicant in Sumsub. It does not trigger or restart verification.

Plugin Actions

API Health – This action checks the keys' validity and the server connection status.

Adding ID Document – This action is used to add an ID document for an applicant.

Creating an Applicant – This action creates a new applicant for verification.

Getting Applicant Data – This action retrieves data of a specified applicant.

Changing Provided Info - Update the applicant’s personal details such as name, gender, date of birth, place of birth, and nationality. Useful for correcting or completing KYC data before verification.

Getting Applicant Status - Use this action to check the current status of an applicant in the Sumsub system. It helps determine if the user has passed verification, is under review, or requires additional documents.

Clarifying the Reason of Rejection - Get a detailed explanation of why an applicant was rejected.

Requesting an Applicant Check - Trigger the verification check manually for an applicant.

Getting Document Images - Retrieve image files for specific documents uploaded by the applicant.

Adding an Applicant to Blocklist – Adds an applicant to your blocklist with an optional note explaining the reason.

Resetting an Applicant – Clears the applicant’s verification history, allowing them to start over.

Changing top-level info – Update applicant’s contact information or language preferences.

Title	Description	Type
Applicant ID	Unique identifier of the applicant	Text
External User ID	New external identifier (optional)	Text (optional)
Email	New email (optional)	Text (optional)
Phone	New phone number (optional)	Text (optional)
Source Key	New sourceKey (optional)	Text (optional)
Lang	Preferred display language	Text (optional)

Return Values:

Title	Description	Type
Applicant ID	Unique identifier of the applicant	Text
Created At	Timestamp of the applicant profile creation	Text
Key	Internal key associated with the applicant	Text
Client ID	Identifier of the Sumsub client account	Text
Inspection ID	Last inspection ID tied to this applicant	Text
External User ID	External reference ID used by your system	Text
Source Key	Custom source key for identifying the submission origin	Text
Info First Name	Applicant’s first name	Text
Info First Name En	Applicant’s first name (in English)	Text
Info Middle Name	Applicant’s middle name	Text
Info Middle Name En	Applicant’s middle name (in English)	Text
Info Last Name	Applicant’s last name	Text
Info Last Name En	Applicant’s last name (in English)	Text
Info Date of Birthday	Applicant’s date of birth	Text
Info Gender	Applicant’s gender	Text
Info Place Of Birth	City or location of birth	Text
Info Place Of Birth En	City or location of birth (in English)	Text
Info Country	Country provided in applicant’s info	Text
Info Nationality	Nationality of the applicant	Text
Info Country Of Birth	Country where applicant was born	Text
Info State Of Birth	State or region of birth	Text
Info Phone	Phone number listed under applicant’s info	Text
Info Addresses	Residential or contact addresses	Text
Info Tin	Tax Identification Number, if provided	Text
Info ID Docs	Array of identity documents submitted	Text
Info Legal Name	Full legal name if available	Text
Fixed Info First Name	Corrected first name (after verification)	Text
Fixed Info Last Name	Corrected last name (after verification)	Text
Fixed Info Dob	Corrected date of birth (after verification)	Text
Fixed Info Gender	Corrected gender (after verification)	Text
Fixed Info Country	Corrected country (after verification)	Text
Email	Updated email address	Text
Phone	Updated phone number	Text
Applicant Platform	Platform or method used for onboarding	Text
Required ID Docs - Doc Sets	Document sets required for verification	Text
Review Review ID	ID of the most recent review	Text
Review Attempt ID	ID of the current review attempt	Text
Review Attempt Cnt	Number of verification attempts	Number
Review Level Name	Name of the review level (e.g. basic, standard)	Text
Review Create Date	Date the review process was initiated	Text
Review Review Status	Current status of the applicant's review	Text
Lang	Language setting for the applicant profile	Text
Type	Type of applicant (individual or business)	Text
Tags	Custom tags assigned to the applicant	Text

Set Risk Level For The Applicant - Assign a manual risk level to an applicant.

Marking Image as Inactive - Deactivates a specific image from an inspection.

Adding Custom Applicant Tags - Attach predefined or custom tags to an applicant profile.

Title	Description	Type
IDENTITY reviewResult.reviewAnswer	Final decision for identity verification (approved / rejected / pending).	Text
IDENTITY reviewResult.moderationComment	Moderator comment explaining the identity review decision.	Text
IDENTITY country	Country associated with the identity document.	Text
IDENTITY idDocType	Type of identity document submitted (e.g., passport, ID card).	Text
IDENTITY imageIds	IDs of images submitted for identity verification.	Text
IDENTITY imageReviewResults	Review results for submitted identity images.	Text
SELFIE reviewResult.reviewAnswer	Final decision for selfie verification.	Text
SELFIE reviewResult.moderationComment	Moderator comment explaining the selfie review decision.	Text
SELFIE country	Country associated with the selfie verification.	Text
SELFIE idDocType	Document type used during selfie verification.	Text
SELFIE imageIds	IDs of images submitted for selfie verification.	Text
SELFIE imageReviewResults	Review results for submitted selfie images.	Text

Title	Description	Type
Applicant ID	The applicant's unique ID.	Text
File URL	URL of the document photo.	Text
ID Doc Type	Type of the ID document (e.g., PASSPORT, DRIVERS, etc.).	Text
Country	3-letter country code.	Text
ID Doc Sub Type	Subtype of ID (e.g., FRONT_SIDE, BACK_SIDE).	Text (optional)
First Name	Applicant's first name.	Text (optional)
Last Name	Applicant's last name.	Text (optional)
Date of birth	Applicant's date of birth.	Text (optional)

Title	Description	Type
Applicant ID	The applicant's unique identifier.	Text
Created At	Timestamp when the applicant was created.	Text
Key	Unique key associated with the applicant.	Text
Client ID	Unique identifier for the client associated with the applicant.	Text
Inspection ID	ID for the inspection of the applicant.	Text
External User ID	External user ID for the applicant.	Text
First Name	Applicant's first name.	Text
First Name En	Applicant's first name (English transliteration).	Text
Last Name	Applicant's last name.	Text
Last Name En	Applicant's last name (English transliteration).	Text
Date of Birthday	Applicant's date of birth.	Text
Email	Applicant's email.	Text
Phone	Applicant's phone number.	Text
Required ID Docs	List of required ID documents for the applicant.	Text
Review ID	Review ID associated with the applicant's verification process.	Text
Attempt ID	Attempt ID for verification attempts.	Text
Attempt Cnt	Number of verification attempts.	Number
Level Name	Level name for the applicant's verification.	Text
Create Date	Date when the applicant was created.	Text
Review Status	Current status of the review process.	Text
Priority	Priority of the applicant's verification.	Number
Type	Type of applicant (e.g., individual, business).	Text

Title	Description	Type
Applicant ID	Unique ID of the applicant.	Text
First Name	First name.	Text (optional)
Last Name	Last name.	Text (optional)
Middle Name	Middle name.	Text (optional)
First Name En	Transliteration of the first name.	Text (optional)
Last Name En	Transliteration of the last name.	Text (optional)
Middle Name En	Transliteration of the middle name.	Text (optional)
Legal Name	Full legal name.	Text (optional)
Gender	Sex of the applicant (M or F).	Text (optional)
Date of Birthday	Date of birth (format: YYYY-MM-DD).	Text (optional)
Place Of Birth	City/town of birth.	Text (optional)
Country Of Birth	Country of birth.	Text (optional)
State Of Birth	State of birth.	Text (optional)
Country	Alpha-3 country code (e.g., NGA, DEU).	Text (optional)
Nationality	Alpha-3 nationality code.	Text (optional)
Tin	Tax Identification Number.	Text (optional)

Title	Description	Type
First Name	Updated first name.	Text
Last Name	Updated last name.	Text
Middle Name	Updated middle name.	Text
First Name En	Transliteration of the first name.	Text
Last Name En	Transliteration of the last name.	Text
Middle Name En	Transliteration of the middle name.	Text
Legal Name	Updated legal name.	Text
Gender	Updated gender.	Text
Date of Birthday	Updated date of birth.	Text
Place Of Birth	Updated place of birth.	Text
Country Of Birth	Updated country of birth.	Text
Country	Updated country code.	Text
Nationality	Updated nationality.	Text
Tin	Updated tax number.	Text
State Of Birth	Updated state of birth.	Text

Title	Description	Type
Response	Whether the request was successful.	Checkbox (yes/no)
Error message	Error message if check failed.	Text

Title	Description	Type
Response	Image file data or link.	Text
Error message	Any error encountered during retrieval.	Text

Title	Description	Type
Result	Indicates whether reset was successful	Checkbox (yes/no)

Title	Description	Type
Result	Was the image marked as inactive?	Checkbox (yes/no)
Error message	Any error encountered	Text

Sumsub Identity Verification

Demo to preview the plugin:

Introduction

Prerequisites

How to Set Up

Step 1. Install the Plugin

Step 2. Generate App Token from the Sumsub Dashboard

Step 3. Configure API Keys & Settings

Step 4. Use the Plugin (Demonstration)

Creating an Applicant

Workflow Configuration: Create Applicant

Workflow Event

Workflow Action

Mapping UI Fields to Plugin Parameters

Handling the Workflow Result

Step 5. Preview & Test

Testing Best Practices

Going Live

Plugin Data Calls

Plugin Actions

Changelogs

Update 18.07.25 - Version 1.26.0

Update 20.06.25 - Version 1.25.0

Update 02.06.25 - Version 1.24.0

Update 02.06.25 - Version 1.23.0

Update 03.04.25 - Version 1.22.0

Update 02.04.25 - Version 1.21.0

Update 02.04.25 - Version 1.20.0

Update 27.02.25 - Version 1.19.0

Update 28.11.24 - Version 1.18.0

Update 20.07.24 - Version 1.17.0

Update 24.06.24 - Version 1.16.0

Update 24.06.24 - Version 1.15.0

Update 06.06.24 - Version 1.14.0

Update 04.04.24 - Version 1.13.0

Update 24.02.24 - Version 1.12.0

Update 18.10.23 - Version 1.11.0

Update 12.10.23 - Version 1.10.0

Update 15.09.23 - Version 1.9.0

Update 08.09.23 - Version 1.8.0

Update 06.09.23 - Version 1.7.0

Update 12.07.23 - Version 1.6.0

Update 24.06.23 - Version 1.5.0

Update 19.06.23 - Version 1.4.0

Update 16.06.23 - Version 1.3.0

Update 16.06.23 - Version 1.2.0

Update 30.05.23 - Version 1.1.0

Update 18.05.23 - Version 1.0.0