@capacitor-community/stripe-identity

Stripe Identity SDK bindings for Capacitor Applications.

Install

npm install @capacitor-community/stripe-identity
npx cap sync

Initialize iOS

set up camera authorization by adding NSCameraUsageDescription in Info.plist and add a string value that explains the usage. see more details on Stripe's native iOS SDK page here.

Initialize Android

change base application theme to Theme.MaterialComponents.DayNight at android/app/src/main/res/values/styles.xml:

- <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
+ <style name="AppTheme" parent="Theme.MaterialComponents.DayNight">

parent can be any MaterialComponents. See here for other options. see more details on Stripe's native Android SDK page here.

Usage

If you want to implement, we recommend to read https://stripe.com/docs/identity .

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

const listener = await StripeIdentity.addListener(IdentityVerificationSheetEventsEnum.VerificationResult, (result) => {
  console.log(result);
  listener.remove();
});

// initialize is needed only for Web Platform
await StripeIdentity.initialize({
  publishableKey,
});
await StripeIdentity.create({
  ephemeralKeySecret,
  verificationId,
  // clientSecret is needed only for Web Platform
  clientSecret
});
await StripeIdentity.present();

API

• initialize(...)
• create(...)
• present()
• addListener(IdentityVerificationSheetEventsEnum.Loaded, ...)
• addListener(IdentityVerificationSheetEventsEnum.FailedToLoad, ...)
• addListener(IdentityVerificationSheetEventsEnum.VerificationResult, ...)
• Interfaces
• Type Aliases
• Enums

initialize(...)

initialize(options: InitializeIdentityVerificationSheetOption) => Promise<void>

| Param | Type | | ------------- | --------------------------------------------------------------------------------------------------------------- | | options | InitializeIdentityVerificationSheetOption |

create(...)

create(options: CreateIdentityVerificationSheetOption) => Promise<void>

| Param | Type | | ------------- | ------------------------------------------------------------------------------------------------------- | | options | CreateIdentityVerificationSheetOption |

present()

present() => Promise<void>

addListener(IdentityVerificationSheetEventsEnum.Loaded, ...)

addListener(eventName: IdentityVerificationSheetEventsEnum.Loaded, listenerFunc: () => void) => Promise<PluginListenerHandle>

| Param | Type | | ------------------ | ---------------------------------------------------------------------------------------------------------- | | eventName | IdentityVerificationSheetEventsEnum.Loaded | | listenerFunc | () => void |

Returns: Promise<PluginListenerHandle>

addListener(IdentityVerificationSheetEventsEnum.FailedToLoad, ...)

addListener(eventName: IdentityVerificationSheetEventsEnum.FailedToLoad, listenerFunc: (info: StripeIdentityError) => void) => Promise<PluginListenerHandle>

| Param | Type | | ------------------ | ---------------------------------------------------------------------------------------------------------------- | | eventName | IdentityVerificationSheetEventsEnum.FailedToLoad | | listenerFunc | (info: StripeIdentityError) => void |

Returns: Promise<PluginListenerHandle>

addListener(IdentityVerificationSheetEventsEnum.VerificationResult, ...)

addListener(eventName: IdentityVerificationSheetEventsEnum.VerificationResult, listenerFunc: (result: IdentityVerificationResult) => void) => Promise<PluginListenerHandle>

| Param | Type | | ------------------ | ---------------------------------------------------------------------------------------------------------------------- | | eventName | IdentityVerificationSheetEventsEnum.VerificationResult | | listenerFunc | (result: IdentityVerificationResult) => void |

Returns: Promise<PluginListenerHandle>

Interfaces

InitializeIdentityVerificationSheetOption

| Prop | Type | | -------------------- | ------------------- | | publishableKey | string |

CreateIdentityVerificationSheetOption

| Prop | Type | Description | | ------------------------ | ------------------- | ----------------------------------------------------- | | verificationId | string | | | ephemeralKeySecret | string | | | clientSecret | string | This client secret is used only for the web platform. |

PluginListenerHandle

| Prop | Type | | ------------ | ----------------------------------------- | | remove | () => Promise<void> |

StripeIdentityError

| Prop | Type | | ------------- | ------------------- | | code | string | | message | string |

IdentityVerificationResult

| Prop | Type | | ------------ | ------------------------------------------------------------------------------------------------------------- | | result | IdentityVerificationSheetResultInterface | | error | StripeIdentityError |

Type Aliases

IdentityVerificationSheetResultInterface

IdentityVerificationSheetEventsEnum.Completed | IdentityVerificationSheetEventsEnum.Canceled | IdentityVerificationSheetEventsEnum.Failed

Enums

IdentityVerificationSheetEventsEnum

| Members | Value | | ------------------------ | ---------------------------------------------------- | | Loaded | 'identityVerificationSheetLoaded' | | FailedToLoad | 'identityVerificationSheetFailedToLoad' | | Completed | 'identityVerificationSheetCompleted' | | Canceled | 'identityVerificationSheetCanceled' | | Failed | 'identityVerificationSheetFailed' | | VerificationResult | 'identityVerificationResult' |