設定

Stripe Identity をインストールし、Capacitor のネイティブプロジェクトを同期します。

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

@capacitor-community/stripe-identity v8.2.1 は、iOS、Android、Web で Stripe Identity Verification Sheet を表示します。

Web の設定

ネイティブプロジェクトへの追加作業は不要です。Web では create と present の前に、公開可能キーを指定して initialize を呼びます。ネイティブ環境では、そのキーを使わずに initialize が完了します。

iOS の設定

アプリがカメラを必要とする理由を記した NSCameraUsageDescription を Info.plist に追加します。Stripe の iOS カメラ認可ガイドを参照してください。

iOS 実装は Info.plist のプライマリアプリアイコン（CFBundleIcons → CFBundlePrimaryIcon → CFBundleIconFiles）を読み取り、最初のファイル名を Stripe Identity の brandLogo として渡します。これらのキーがない場合、create は拒否され、FailedToLoad が発生します。

Xcode が CFBundleIconFiles を書き込めるよう、iOS のアセットカタログにプライマリ App Icon を保持してください。アイコンカタログがないアプリではシートを作成できません。

Android の設定

android/app/src/main/res/values/styles.xml で Material Components テーマを使用します。

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

Material Components の任意の親テーマを利用できます。Material Components のテーマ設定と Stripe の Android Material テーマガイドを参照してください。

Android 実装はアプリケーションの ic_launcher mipmap を本人確認シートのアイコンとして使用します。標準のランチャーアイコン以外の設定は不要です。