アカウント登録

要件の収集オプション

ユーザー登録コンポーネントを使用して情報を収集する場合、常に currently_due 要件を徴収します。collectionOptions 属性を使用すると、次のいずれかをリクエストすることもできます。

• eventually_due 要件
• 今後の要件
• 粒度の細かい 要件の制限

連結するアカウントの特定の要件については、必要な検証情報 を参照してください。

要件制限

回収オプションを指定する際に、要件の制限を only または exclude として細かく設定できます。どちらのオプションでも、アカウントの currently_due または eventually_duerequirements を表す文字列の配列を指定できます。連結アカウントに適用される要件の詳細については、必要な確認情報をご覧ください。

exclude は一致する口座要件をフィルタリングし、only は口座要件と指定された値の交差として機能します。また、* やリレーション接頭辞を使ったワイルドカードマッチングにも対応しています。

例えば、複数の所有者がいる連結アカウントがある場合、only: ["owners.address.*"] を指定することで、すべての所有者の住所情報を徴収することができます。

人物には複数のリレーションシップを関連付けることができ、また、リレーションシップは複数の担当者に割り当てることができます。そのため、リレーションシップ接頭辞を活用すると、指定したリレーションシップを持つ口座のすべての人に適用されます。これは、特定の人物の ID はわからないが、その人物のリレーションシップはわかっている場合に特に便利です。

重要な考慮事項:

• ケイパビリティを有効にするためには、口座はすべての KYC 要件を満たす必要があります。exclude オプションは要件を削除するのではなく、その時点で徴収しないようにするだけです。情報は引き続き徴収する必要があります。
• これらの制限は、埋め込みコンポーネント内でのみ適用されます。他のタイプのダッシュボードを使用している口座には影響しません。
• この機能はユーザー体験を向上させるためのものであり、口座からの情報へのアクセスを防ぐためのものではありません。

限定要件制限

このオプションは、その口座で未解決の、指定された要件のセットに回収をスコープします。このオプションは、改善策を構築するために最もよく用いられ、何らかの形式の文書のアップロードや本人確認を必要とする要件に特に有用です。

このオプションは、ユーザー登録が標準の最終サマリーステップを表示しないようにします。指定されたすべての要件が提供された場合、ユーザー登録コンポーネントは直ちに終了します。

除外要件制限

このオプションは指定されたフィールドを非表示にし、連結するアカウントがその情報を提供したり編集したりできないようにします。このオプションは、コンポーネントからフィールドを非表示にするだけで、必要な情報を削除するわけではありません。このオプションは、ユーザー登録時に連結アカウントにアクセスさせたくない情報をあらかじめ入力しておく場合に便利です。

Express アカウントの場合、exclude で business_type の要件 (アカウントによる事業形態の変更を防ぐなど) を除外する場合は、アカウントの国とケイパビリティを設定する必要があります。

外部口座の収集

external_account_collection 機能を使用して、コンポーネントで外部口座情報を収集するかどうかを制御します。このパラメーターはデフォルトで有効になっており、要件が期限切れになったときや変更されたときに最新情報を収集する責任を負うプラットフォーム (Custom アカウントを含む) のみが無効にできます。external_account_collection が有効になっている場合は、ユーザー認証が必要です。disable_stripe_user_authentication パラメーターを使用して Stripe ユーザー認証からオプトアウトできます。

Stripe ユーザー認証を無効にする

disable_stripe_user_authentication 機能を使用して、コンポーネントで Stripe ユーザー認証が必要かどうかを制御します。デフォルト値は、external_account_collection 値の反対です。たとえば、external_account_collection を設定していない場合、disable_stripe_user_authentication はデフォルトで false になります。この値は、controller.requirement_collection が application であるアカウントに対してのみ true になります。

ベストプラクティスとして、2 段階認証または同等のセキュリティ対策を導入することをお勧めします。この機能をサポートするアカウント (Custom アカウントなど) の設定により、連結アカウントがマイナス残高を返済できない場合は、お客様がそのアカウントに代わって責任を負います。

ユーザーに表示するポリシーをカスタマイズする

Stripe の利用規約とプライバシーポリシーは、オンラインのアカウント登録で連結アカウントに提示されます。Stripe の利用規約に同意していない連結アカウントは、アカウント登録の最後の画面で規約を受け入れるように求められます。また、オンラインのアカウント登録のフッターにも、Stripe の利用規約とプライバシーポリシーへのリンクが掲載されています。

プラットフォームが要件の収集を行う連結アカウントに対しては、アカウント登録フローをカスタマイズする追加オプションがあります。以下に概要を示します。

自社で利用規約への同意を管理する

プラットフォームとして、貴社が必要な情報を収集する責任を負う連結アカウントを登録している場合、Stripe のオンラインのアカウント登録コンポーネントではなく、自社のプロセスを使用して利用規約への同意を収集できます。自社のプロセスを使用する場合、アカウント登録の最終画面では、連結アカウントには入力した情報の確認のみが求められます。Stripe の利用規約への同意は貴社で確実に取得する必要があります。

ただし、オンラインのアカウント登録には (フッターなどに) 利用規約へのリンクが表示されます。このリンクを、自社の規約およびプライバシーポリシーへのリンクで置き換えることを選択できます。

利用規約およびプライバシーポリシーへのリンク

Stripe の利用規約とプライバシーポリシーはオンライン登録のいたるところで連結アカウントに提示されます。貴社が要件の収集に責任を負う連結アカウントの場合、これらのリンクを自社の規約とポリシーに置き換えることができます。以下の手順に従って Stripe 利用規約を組み込み、Stripe プライバシーポリシーにリンクします。

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "components[account_onboarding][enabled]"=true \
  -d "components[account_onboarding][features][disable_stripe_user_authentication]"=true

class MyViewController: UIViewController, AccountOnboardingControllerDelegate {
    override func viewDidLoad() {
        super.viewDidLoad()

        // Optional. If you use CollectionOptions, make sure to follow our policy instructions.
        // let collectionOptions = AccountCollectionOptions()
        // collectionOptions.fields = .eventuallyDue
        // collectionOptions.futureRequirements = .include

        let accountOnboardingController = embeddedComponentManager.createAccountOnboardingController(
            // fullTermsOfServiceUrl: URL(string: "{{URL}}")!,
            // recipientTermsOfServiceUrl: URL(string: "{{URL}}")!,
            // privacyPolicyUrl: URL(string: "{{URL}}")!,
            // collectionOptions: collectionOptions
        )

        accountOnboardingController.delegate = self
        controller.title = "Onboard with Stripe"

        // Display the component in your app
        accountOnboardingController.present(from: self)
    }

    // MARK: - AccountOnboardingControllerDelegate

    func accountOnboardingDidExit(_ accountOnboarding: AccountOnboardingController) {
        print("User exited the onboarding flow")
    }
}