Stripe Identity

Brandarrow's official documentation for Stripe Identity – Bubble.io Plugin.

---

Vitals

Description

The "Stripe Identity" plugin by Brandarrow is a comprehensive and user-friendly Bubble.io plugin that enables developers to incorporate Stripe’s robust identity verification directly into their applications. This plugin allows your app to securely verify user identities by showing a Stripe-hosted verification popup, ensuring compliance and a smooth onboarding experience.

With this plugin, you can quickly initiate the Stripe Identity flow from within your Bubble.io project. Whether your use case involves verifying document-based identity, confirming user details for compliance, or enhancing security for sensitive actions, Stripe Identity by Brandarrow offers a powerful, customizable solution for you. By easily adding and triggering the verification modal, you ensure that the user experience is efficient and compliant with industry standards.

The Stripe Identity plugin streamlines the complex process of identity verification, enabling a secure and intuitive flow for your users. With a strong focus on data privacy and security, this plugin ensures that your platform remains compliant and provides a seamless experience across all devices.

Price

$45/once | OR | $10/month

Installation

Stripe Identity Plugin for BubbleBubble

Add the plugin to your Bubble app via the official plugin marketplace.

Demo & Editor

Demo Editor

---

Instructions

1

Add the Stripe Identity Element

Place the StripeIdentity element on the page where verification will occur.

2

Configure API Keys

In the plugin settings, enter your Stripe secret key with the Bearer prefix.

In the workflow, provide the Publishable key and Client secret (generated via Stripe’s Identity API).

3

Trigger Verification

Use the Initialize Stripe Identity Verification action in a workflow to start the verification process. Provide the required Publishable key and Client secret.

4

Track Completion & Errors

Use the following events in workflows to handle outcomes:

Stripe Identity - Verified: Triggered on successful verification.

Stripe Identity - Canceled: Triggered on cancellation or error.

5

Reset Session (Optional)

Use the Reset Stripe Identity State action to clear the verification status, allowing users to re-verify without refreshing the page.

That's it you are ready to use the plugin

Components

Element

• Stripe Identity : Renders Stripe’s verification modal on the page.

Actions

• Stripe Identity by Brandarrow - Retrieve Verification Session

• Stripe Identity by Brandarrow - Cancel Verification Session

• Stripe Identity by Brandarrow - Redact Verification Session

• Initialize & Show Identity Verification Popup a Stripe Identity

• Reset Identity Verification Modal a Stripe Identity

Events

• A Stripe Identity a verification session is completed: Fires when verification is successful.

• A Stripe Identity a verification session runs into error: Fires when the user cancels or an error occurs

Data calls

• Stripe Identity by Brandarrow - Create Verification Session

• Stripe Identity by Brandarrow - Retrieve Verification Session

• Stripe Identity by Brandarrow - List Verification Session

---

Common Issues & Troubleshooting

Issue	Cause	Solution
Modal Does Not Appear	Incorrect or expired Publishable key or Client secret	Verify that the Publishable key and Client secret are correct and properly entered in the workflow. Regenerate the Client secret via Stripe’s Identity API if expired or invalid.
Verification Completes but No Event Fires	Missing workflow or hidden element	Ensure a workflow is attached to the Stripe Identity - Verified or Stripe Identity - Canceled event. Check that the StripeIdentity element is not hidden on the page.
“Invalid Key” Error	Incorrect secret key format or wrong mode	Confirm the Stripe secret key in plugin settings is prefixed with Bearer (e.g., Bearer sk_test_...). Use Stripe’s test keys for sandbox mode testing.
Reset Action Not Clearing Modal	Reset action triggered prematurely	Ensure the Reset Stripe Identity State action is triggered after the modal returns a status (success or cancel). Avoid triggering the reset while the modal is still open.
Mobile Display Issues	Non-responsive modal or mobile wrapper issues	Test the modal in mobile browsers to ensure responsiveness. Verify that the Stripe modal is not blocked by mobile wrapper configurations.
Unexpected Errors	API issues or invalid Client secret	Check Stripe’s Dashboard for API error logs to diagnose key validation or API call issues. Ensure the Client secret is generated correctly via Stripe’s Identity API.

---

Version	Status	Date	Changes
v1.0.0	Shipped	1/6/25	Initial release

---

Support

Help & Support

---