Stripe へのアカウントの移行

支払いを中断せずに、Stripe でのアカウントの処理を開始します。

Stripe では、既存の連結アカウントを支払いデータおよび顧客データとともに移行できます。こうすると、引き続き、支払いを回収して入金するか、他のビジネスが支払いを直接受け付けられるようにすることができます。既存のプラットフォームビジネスを Stripe に正常に移行するには、以下を行う必要があります。

移行プランとタイムラインを作成する
連結アカウントの連携を更新する
アカウントを作成してアカウント登録を行う
未対応の要件と継続的な要件を処理する
支払いデータと顧客データを Stripe に移行する

移行プランを作成する

Stripe への移行が成功するためには、移行プラン、タイムライン、連結アカウントの顧客確認情報、支払いデータと顧客データが必要です。

連結アカウントは、Stripe のアカウント登録を行う必要があります。そのためには、各アカウントの Stripe 本人認証 (KYC) データを送信する必要があります。Stripe の要件により、追加情報をアカウントから収集する必要が生じる場合があります。分析を実行して、以前のプロバイダーで収集したデータと Stripe で必要なデータを把握します。Stripe は、連結アカウントを有効にする前に、本人認証 (KYC) データを確認します。account.updated イベントまたは Retrieve Account API を使用して、アカウントの確認ステータスを調べてください。確認できなかったアカウントは、有効化の前にアクションを実行する必要があります。

Stripe へのアカウント登録後の支払いデータの厳密な移行日を含めます。支払いデータと顧客データには、移行の一環として PAN のインポートが必要です。アカウントは一括でインポートすることをお勧めします。

連携を更新する

Stripe に移行するための連携の更新の一環として、アプリケーションで変更が必要になる場合があります。たとえば、料金体系の更新など、連結アカウントによるプラットフォームの使用法の変更が必要ないか検討してください。変更内容を事前にアカウントに連絡することをお勧めします。

Stripe 利用規約への同意

連結アカウントが有効化されるためには、Stripe 利用規約に同意する必要があります。

要件の期限が来た場合や要件に変更があった場合に Stripe が更新された情報を収集する責任を負うアカウント (Standard アカウントおよび Express アカウントを含む) の場合、アカウントはアカウント登録フロー内で Stripe の利用規約に同意する必要があります。

要件に変更があった場合に連結アカウント (Custom アカウントを含む) から更新された情報を収集する責任を負うアカウントの場合は、you can 自社の利用規約に Stripe の利用規約を含めることができます。利用規約への同意はアカウント登録フローの末尾に配置することをお勧めしますが、自社にとって冒頭に配置した方が適切な場合は冒頭でも構いません。連結アカウントを作成または更新する場合、更新された利用規約情報への同意を記録して Stripe に送信し、その旨をアカウントに通知してください。

連結アカウントを Stripe に登録する

Stripe は連結アカウント向けにさまざまなレベルのアカウント登録のサポートを提供しています。次のいずれかの方法で連結アカウントの登録フローを構築してください。

方法	長所	短所
Stripe のホスティング登録	導入の負担が最も小さい	Stripe のブランド名を使用して、プラットフォームのブランディングを制限フローロジックに対する制御に制限がある連結アカウントは、貴社のサイトを離れずにプロセスを完了するのではなく、Stripe にリダイレクトされる
Embedded onboarding	カスタマイズの自由度が高い Stripe 以外のブランディングに限定連結アカウントは自社サイトのフローに残る導入の負担が小さい	フローロジックに対する制御に制限がある
API ベースのアカウント登録	自社の UI を完全にコントロールする	構築するのに高額の費用と時間がかかる維持管理の負担が増大し続ける (特に、絶えず変化するグローバル要件への対応の負担が大きい) Stripe のリスク審査を解決することはできません

アカウントを作成してアカウント登録を行う

以下は、プロセスの概要です。

アカウント要件を設定する

以下の要因は、連結アカウントの登録要件に影響します。

連結アカウントの所在国
連結アカウントに適用される利用規約タイプ
連結アカウントでリクエストされるケイパビリティ
The business_type (for example, individual or company) and company.structure (for example, public_corporation or private_partnership)

対話型フォームを使用して、これらの要因を変更すると要件にどのような影響が出るかを確認できます。

要件フォーム

連結アカウントを作成する

Stripe に移行するアカウントごとに、関連する Account を作成します。

Create Account API を使用し、controller を必要なアカウント設定に指定して連結アカウントを作成します。あらゆる情報を事前入力できますが、少なくとも controller は指定する必要があります。アカウントの国は、デフォルトでプラットフォームと同じ国が設定され、アカウントはアカウント登録時の選択を確定します。

注

この例には、アカウント作成時に設定できるフィールドの一部のみが含まれています。 address や website_url など、設定可能なフィールドの一覧については、Create Account API リファレンスをご覧ください。

連結アカウントの情報をすでに収集している場合は、Account オブジェクトにその情報を事前入力できます。個人情報や事業情報、外部のアカウント情報など、あらゆるアカウント情報を事前に入力できます。

Connect アカウント登録で、事前入力された情報が要求されることはありません。ただし、アカウント所有者は Connect 利用規約に同意する前に、事前入力された情報を確認するよう求められます。

実装内容をテストする場合、テストデータを使用してアカウント情報を事前入力します。

作成に成功すると、Accout オブジェクトが返されます。オブジェクトで連結アカウントの id を調べ、その値をデータベースに保存します。

{
  ...
  "id": "{{CONNECTED_ACCOUNT_ID}}"
,
  ...
}

すべての既存のデータを適用して Stripe を更新した後、未対応の要件がないか探します。未対応の要件は、currently_due 配列に一覧表示されます。currently_due のすべての要件をアカウントから収集する必要があります。これは、Stripe がアカウントを確認して、アカウントのケイパビリティを有効にするために必要です。

{
  ...
  "requirements": {
    "alternatives": [],
    "current_deadline": null,
    "currently_due": [
      "business_profile.url",
      "external_account",
      "individual.first_name",
      "individual.last_name",
      "tos_acceptance.date",
      "tos_acceptance.ip"
    ],
    "disabled_reason": "requirements.past_due",
    "errors": [],

アカウントの既存のデータをすべて入力したら、アカウントをStripe UI に誘導して、Stripe 認証情報を設定します。情報を確認して、Stripe 利用規約に同意します。

新しいアカウントにアカウント登録フローをガイドする

既存のアカウントを移行するほか、新規アカウントを Stripe に登録するためのフローを構築します。このアカウント登録フローを使用して、移行対象のアカウントについて不足しているデータを収集することもできます。

アカウント登録のオプションを確認して、アカウント登録フローを作成します。

未対応の要件と継続的な要件を処理する

連結アカウントのデータが送信されると、Stripe はそれを確認します。このプロセスには、必要な確認に応じて数分または数時間かかることがあります。このプロセスの進行中、リクエストしたケイパビリティは保留中のステータスになります。

ステータスを確認する

連結アカウントのケイパビリティのステータスは、以下によって取得できます。

Account オブジェクトの capabilities ハッシュで、関連するケイパビリティを確認します。
Capabilities API から直接ケイパビリティをリクエストし、関連するケイパビリティのステータスを確認します。
Webhook エンドポイントで account.updated イベントをリッスンし、関連するケイパビリティの capabilities ハッシュを確認します。

確認が完了すると、ケイパビリティは active になり、連結アカウントで利用できるようになります。アカウントの確認は継続的に実行され、それ以降に確認が失敗すると、ケイパビリティは active から移行します。account.updated イベントをリッスンして、ケイパビリティの状態の変化を検知します。

構築済みの Connect の実装内容が法令を遵守し、稼働中であることを確認するには、アカウントの charges_enabled と payouts_enabled が両方とも true であることを確認します。API を使用するか、account.updated イベントをリッスンすることができます。その他の関連フィールドについて、詳細はアカウントの requirements (要件) ハッシュを確認してください。アプリケーションおよび関連ポリシーに応じてステータスが変化する可能性があるため、単一の値に基づいて実装を確認することはできません。

charges_enabled は、支払いと送金を含む全体的な支払いパスが正しく機能することを確認し、card_payments と transfers ケイパビリティのどちらがアクティブになっているかを評価します。
payouts_enabled は連結アカウントが外部口座に入金できるかを評価します。リスクポリシーによっては、連結アカウントが入金を有効にせずに取引を開始することを許可できます。連結アカウントに支払うには、最終的には入金を有効にする必要があります。

以下のロジックは、連結アカウントに表示するサマリーのステータスを定義するための開始ポイントとして使用できます。

Ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 'sk_test_BQokikJOvBiI2HlWgH4olfQ2'


def account_state(account)
  reqs = account.requirements

  if reqs.disabled_reason && reqs.disabled_reason.include?("rejected")
    "rejected"
  elsif account.payouts_enabled && account.charges_enabled
    if reqs.pending_verification
      "pending enablement"
    elsif !reqs.disabled_reason && !reqs.currently_due
      if !reqs.eventually_due
        "complete"
      else
        "enabled"
      end
    else
      "restricted"
    end
  elsif !account.payouts_enabled && account.charges_enabled
    "restricted (payouts disabled)"
  elsif !account.charges_enabled && account.payouts_enabled
    "restricted (charges disabled)"
  elsif reqs.past_due
    "restricted (past due)"
  elsif reqs.pending_verification
    "pending (disabled)"
  else
    "restricted"
  end
end

accounts = Stripe::Account.list(limit: 10)

accounts.each do |account|
    puts "#{account.id} has state: #{account_state(account)}"
end

確認エラーを処理する

アカウント登録フローに応じて、確認失敗に対する対処方法を変えます。

注

API を使用して Stripe のリスク審査に対応することはできません。埋め込みコンポーネント、Stripe のホスティング登録、または修復リンクを使用して、連結アカウントが対応できるように設定できます。ダッシュボードを使用して、連結アカウントの代わりにリスク審査に対応することもできます。

account.updated イベントをリッスンします。current_deadline が着信したときにアカウントに currently_due フィールドが含まれている場合は、対応する機能が無効になり、そのフィールドが past_due に追加されます。

アカウントが情報の修正に使用できる明確な指示が記載されたフォームを作成します。アカウントに通知し、次に Accounts API を使用して、修正された情報を送信します。

すべての確認エラーに対処するカスタムフローの作成を計画している場合:

可能性のあるすべての確認エラーとその対処法に関する詳細を確認します。
確認状態をテストします。

支払いデータと顧客データを Stripe に移行する

Stripe で連結アカウントが作成された後、支払いデータと顧客データを移行して Stripe で使用できるようにする PAN データのインポートをリクエストします。

注