Stripe へのアカウントの移行

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

1. 移行プランとタイムラインを作成する
2. 連結アカウントの連携を更新する
3. アカウントを作成してアカウント登録を行う
4. 未対応の要件と継続的な要件を処理する
5. 支払いデータと顧客データを 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 は連結アカウント向けにさまざまなレベルのアカウント登録のサポートを提供しています。次のいずれかの方法で連結アカウントの登録フローを構築してください。

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

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

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

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

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

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

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

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

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[fees][payer]"=account \
  -d "controller[losses][payments]"=stripe \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[requirement_collection]"=stripe \
  -d country=US \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true

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

{
  ...
  "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": [],

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

When the connected account’s data is submitted, Stripe verifies it. This process might take minutes or hours, depending on the nature of the verification. During this process, the capabilities you requested have a status of pending.

ステータスを確認する

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

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

After verifications are complete, a capability becomes active and available to the connected account. Account verifications run continuously, and if a future verification fails, a capability can transition out of active. Listen for account.updated events to detect changes to capability states.

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

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

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

# 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

確認エラーを処理する

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

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

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