Getting Started

Copy a setup prompt with the install steps and the full markdown guide for this plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-stripe-identity`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/stripe-identity/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Install

bun add @capgo/capacitor-stripe-identity
bunx cap sync

Import

import { StripeIdentity } from '@capgo/capacitor-stripe-identity';

Quick start

import { StripeIdentity } from '@capgo/capacitor-stripe-identity';

await StripeIdentity.initialize({ publishableKey: 'publishable-key-123' });

Example: create

import { StripeIdentity } from '@capgo/capacitor-stripe-identity';

await StripeIdentity.create({
  verificationId: 'verification-id-123',
  ephemeralKeySecret: 'ephemeral-key-secret',
});

Example: present

import { StripeIdentity } from '@capgo/capacitor-stripe-identity';

await StripeIdentity.present();

Common pitfalls

Listeners: remove handles when screens unmount.
Initialize once: run setup during app bootstrap.
Source of truth: trust src/definitions.ts in the GitHub repo.

Verification flow

Create a VerificationSession on your backend, then pass the IDs to the plugin:

await StripeIdentity.initialize({ publishableKey: 'pk_test_...' });

await StripeIdentity.create({
  verificationId: 'vs_...',
  ephemeralKeySecret: 'ek_...',
  clientSecret: 'vs_..._secret_...', // web only
});

await StripeIdentity.present();

Example app

git clone https://github.com/Cap-go/capacitor-stripe-identity.git
cd capacitor-stripe-identity/example-app
bun install
bun run start

Source Of Truth

This page documents the current public API from Cap-go/capacitor-stripe-identity.