コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

すべてが埋め込まれた Connect プラットフォームの連携

自社のウェブサイトを通じて Connect の機能を連結アカウントに提供します。

Connect の組み込みコンポーネントを使用すると、SaaS プラットフォームやマーケットプレイスなど、連結アカウントに提供するカスタムインターフェイスに、Stripe が管理する機能を追加できます。Stripe ダッシュボードを使用することなく、ここで決済関連のアクティビティを実行できます。完全組み込み型の導入では、以下が実現します。

  • 連結アカウントは、プラットフォームのアプリケーションに埋め込まれたコンポーネントを使用して、Stripe に関連するデータ、フォーム、通知にアクセスします。連結アカウントには、Stripe ダッシュボードへのアクセス権がありません。
  • Stripe は連結アカウントのクレジットリスクと不正利用リスクを管理します。リスクやコンプライアンスに関する対応については、Stripe が連結アカウントと直接やり取りし、連結アカウントは埋め込みコンポーネントを操作して対応します。
  • Stripe のメール通知により、連結アカウントは、情報を確認したり、必要なアクションを行ったりするために、ユーザーのウェブサイトの埋め込みコンポーネントに誘導されます。ユーザーはこれらのコンポーネントの URL を Stripe に提供する必要があります。

デモのサイトを見る

Stripe では、架空ビジネス Furever のデモサイトを構築しました。Furever は、ペットトリマーが支払いを回収できるようにするソフトウェアを提供するプラットフォームです。このデモでは、アカウント登録やアカウント管理など、多くの埋め込みコンポーネントを操作できます。

はじめに

埋め込み型の組み込みを構築する前に、次の前提条件をすべて満たす必要があります。

  1. プラットフォームを登録します。
  2. ビジネスの詳細を追加して、本番環境利用の申請を行います。
  3. プラットフォームプロフィールを完成させます。
  4. ブランド設定をカスタマイズします。ビジネス名、アイコン、ブランドカラーを追加します。

プラットフォームが独自の料金体系を提供するかどうかを決定する必要もあります。そのようにする場合、 Stripe はプラットフォームから決済手数料を徴収し、お客様は連結アカウントに請求します。そのようにしない場合は、 Stripe が独自の料金体系を提供し、連結アカウントから直接、決済手数料を徴収します。

連結アカウントを作成

次の例では、Stripe が リスクを管理し、料金体系を管理し、アカウントのユーザー登録に関する要件の責任を引き受ける連結アカウントを作成します。プラットフォームは組込みコンポーネントを使用し、連結アカウントのマイナス残高に対する責任を負いません。連結アカウントは、Stripe がホストするダッシュボードにアクセスできません。

メモ

この例では Stripe が料金体系を管理するので、Documents 組込みコンポーネントを導入する必要があります。さらに、Stripe は、タックスインボイスまたは 1099 申告書のダウンロードが可能になると、連結アカウントにメールで通知します。プラットフォームで料金体系が管理されるアカウントを作成する場合、Documents コンポーネントは必要ありません。また、Stripe は連結アカウントにタックスインボイスまたは 1099 申告書に関する通知を送信しません。

アカウントのユーザー登録後に、特定の決済手段などの追加ケイパビリティをリクエストできます。

次のパラメーターを指定して /v1/accounts を呼び出します。

  • アカウントの country
  • controller.stripe_dashboard.type = none
  • card_payments ケイパビリティと transfers ケイパビリティをリクエストする
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d country=US \
  -d "controller[stripe_dashboard][type]"=none \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true
Example response
{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}"
,
  "object": "account",
  "controller": {
    "type": "application",
    "is_controller": true,
    "losses": {"payments": "stripe"},
    "fees": {"payer": "account"},
    "requirement_collection": "stripe",
    "stripe_dashboard": {
      "type": "none",
    },
  },
  "type": "none",
  ...
}

組込みコンポーネントを設定する

連結アカウントは、アカウントや主要な決済機能にプラットフォームで直接アクセスします。Stripe が提供するダッシュボードにはアクセスできないため、ウェブサイトを介して特定の機能へのアクセスを提供する必要があります。

実装には、以下の組込みコンポーネントを含める必要があります。

導入では、個別の決済に関する反証資料で不審請求の申し立てに対応する方法も提供する必要があります。これは、Stripe の API または組込みコンポーネント (Payments、Payment details、Disputes for a payment) を使用して実装できます。

マイナス残高を回避し、ビジネスの中断を防ぐために、必要に応じて連結アカウントが資金を追加できるようにする方法を提供することをお勧めします。これは、組込みコンポーネント (Balances または Payouts) を使用して実装できます。

また、追加の組込みコンポーネントを導入することや、API を使用して独自の UI を構築することもできます。

連結アカウントのユーザー登録前に、組込みコンポーネントを設定していることを確認してください。

ベストプラクティス

導入の効果を最大化するには、以下の戦略を検討してください。

  1. ユーザー重視: アカウントユーザー登録コンポーネントを使用し、プロセスをシンプルなステップに分割してわかりやすい手順を提供することで、ユーザー登録プロセスを直感的なものにします。これにより、ユーザーはアカウントの作成と管理をスムーズに行えます。
  2. 法令遵守を促す: 通知バナー コンポーネントを使用して、ユーザーが法令遵守ステータスや未対応の要件を常に把握できるようにします。ダッシュボードのホームページなど、アプリケーションの目立つ場所にバナーを配置し、バナーが表示されるようにして、必要な書類や更新に対してタイムリーなアクションを促します。
  3. レスポンシブ設計: 導入するコンポーネントがデバイス間でレスポンシブであることを確認します。連結アカウントはモバイル端末など、さまざまなデバイスからプラットフォームにアクセスする可能性があるため、ユーザー登録と管理インターフェイスがさまざまな画面サイズで効果的に機能することを確認します。
  4. ユーザー認証とセキュリティ: ユーザー登録とアカウント管理のプロセス中に強力な認証手段を実装します。Stripe 認証は機密性の高いアカウント情報と入金情報の変更機能を保護しますが、その他の機密情報は製品の認証とセキュリティのみに依存します。ワンタイム SMS コードや二要素認証などの方法を使用して、全体的なセキュリティを強化できます。
  5. フィードバックメカニズム: ユーザー登録フローと管理コンポーネントにフィードバックオプションを導入します。ユーザーが問題を報告し、改善を提案できるようにすることで、ユーザーからのフィードバックに基づいてプラットフォームを継続的に強化できます。
  6. プロアクティブなエンゲージメント: メールまたはプラットフォームの通知を通じて法令遵守義務に関するリマインダーやアラートを送信することで、ユーザーにアクティブなアカウントの維持を促します。このプロアクティブなアプローチは、アカウントの停止やそれに伴う不満の防止に役立ちます。

連結アカウントをユーザー登録する

Stripe は AccountSession を使用して、連結アカウントに組込みコンポーネントアクセスを提供する意図を表します。AccountSession を使用すると、組込みアカウントユーザー登録コンポーネントは、リクエストされたケイパビリティに基づき必要なすべての情報を収集します。

アカウントを事前入力する

AccountSession を作成する前に、Account プロパティに既知の情報を事前入力することで、連結アカウントのユーザー登録フローを効率化できます。ユーザー登録コンポーネントは、Account にすでに存在する情報をリクエストしません。以下の手順に従って、会社、個人、外部アカウント情報など、できるだけ多くの情報を事前入力します。

  1. 必要な確認情報ツールを使用して、連結アカウントの所在地、事業形態、リクエストされたケイパビリティに基づく要件を確認します。
  2. 要件に一致する事前入力可能な情報を収集します。
  3. Account の作成時に収集した情報を提供するか、Account を更新してユーザー登録前に追加します。

Account を作成してケイパビリティをリクエストしたら、requirements プロパティでそのアカウント固有の要件を確認できます。

プラットフォームはマイナス残高に対する責任を負わないため、入金口座や法人情報など、一部の連結アカウント情報へのアクセスが制限されます。連結アカウントがアカウントユーザー登録の組込みコンポーネントを使用してユーザー登録を完了すると、プラットフォームはそれらのプロパティを更新できなくなります。連結アカウント自身がそれらを更新する必要があります。

組込みユーザー登録コンポーネントを使用してユーザー登録を行う

連結アカウントが支払いと入金を有効にするには、ユーザー登録を行い、必要な情報を提供する必要があります。連結アカウントをユーザー登録するには、自社のサイトでユーザー登録の組込みコンポーネントをホストし、そこに新しいアカウントを誘導します。

アカウントセッションを作成する

アカウントセッションの作成時に、components パラメーターで account_onboarding を指定して、アカウント登録を有効にします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[account_onboarding][enabled]"=true

アカウントのユーザ登録コンポーネントを表示する

アカウントセッションを作成して ConnectJS を初期化すると、フロントエンドにアカウント登録コンポーネントを表示できます。

account-onboarding.js
JavaScript
React
No results
// Include this element in your HTML
const accountOnboarding = stripeConnectInstance.create('account-onboarding');
accountOnboarding.setOnExit(() => {
  console.log('User exited the onboarding flow');
});
container.appendChild(accountOnboarding);

// Optional: make sure to follow our policy instructions above
// accountOnboarding.setFullTermsOfServiceUrl('{{URL}}')
// accountOnboarding.setRecipientTermsOfServiceUrl('{{URL}}')
// accountOnboarding.setPrivacyPolicyUrl('{{URL}}')
// accountOnboarding.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })
// accountOnboarding.setOnStepChange((stepChange) => {
//   console.log(`User entered: ${stepChange.step}`);
// });

アカウントの主たる所有者にユーザー登録フローを表示します。主たる所有者とは Stripe での認証を設定し、アカウント情報の編集とリスクに対する対処が可能なユーザーです。連結アカウントに設定可能な Stripe に対する認証情報は 1 つのみです。認証情報が設定されたユーザーは、ワンタイム SMS コードを使用して、入金先の銀行口座の更新や更新後の法人情報の提供などの機密性の高い操作を実行できます。

ユーザー登録イベントを待ち受ける

連結アカウントがユーザー登録を進める際、account.updated イベントが設定済みの Connect Webhook にも送信されます。アカウントが詳細の送信を完了すると、Account の details_submitted プロパティが true に変わります。Webhook ハンドラの account.updated イベント本文で details_submitted: true を探すか、Account を取得して、ステータスを確認します。details_submitted が false の場合は、組込みユーザー登録コンポーネントを再度表示します。このコンポーネントは、すでに送信済みの情報をスキップし、送信されていない要件のみを収集します。

連結アカウントが詳細を送信してユーザー登録フローを完了すると、組込みのユーザー登録コンポーネントは、コンポーネントを表示する際に設定した onExit ハンドラを呼び出します。このコールバックを使用して、アカウントを次のアクションに誘導します。終了ハンドラを設定しない場合、またはこのハンドラ内でアクションを行わない場合、アカウントには、次に実行する明確なステップが示されずに完了メッセージが表示されます。

追加のケイパビリティをリクエストする (オプション)

連結アカウントのユーザー登録後も、プラットフォームで 追加のケイパビリティを引き続きリクエストできます。たとえば、アカウントに対して有効にするすべての決済手段のケイパビリティをリクエストする必要があります。

リクエストされたケイパビリティで追加情報が必要な場合、連結アカウントは組込み通知バナーを介して通知を受け取ります。

継続的な法令遵守とリスクの更新を処理する

Stripe が連結アカウントのクレジットリスクと不正利用リスクを管理するため、アカウントは Stripe からのアラートを確認し、これに対応できなければなりません。これらを容易にするために、プラットフォームに通知バナーとアカウント管理の組込みコンポーネントを組み込む必要があります。これらのコンポーネントを通じて Stripe が連結アカウントをどのようにサポートするかについて詳しくは、組込み型 Connect サポートをご覧ください。

通知バナーを組み込む

Stripe は通知バナー組込みコンポーネントを使用して、未対応の法令遵守要件やその他のリスク関連リクエストを連結アカウントに通知します。これらの通知に対応することで、アカウントは、決済処理と入金受け取りができるように法令遵守を維持できます。未対応の通知がない場合は、組込み通知バナーは表示されません。

ウェブサイトのアクセスしやすい目立つ場所に通知バナーを組み込みます。たとえば、決済画面の上部などに組み込むことができます。

アカウントセッションを作成する

アカウントセッションの作成時に、components パラメーターで notification_banner を指定して、通知バナーを有効にします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[notification_banner][enabled]"=true \
  -d "components[notification_banner][features][external_account_collection]"=true

通知バナーコンポーネントを表示する

notification-banner.js
JavaScript
React
No results
// Include this element in your HTML
const notificationBanner = stripeConnectInstance.create('notification-banner');
container.appendChild(notificationBanner);

// Optional:
// notificationBanner.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })

バナー通知に応答するには、アカウントは通知内のボタンをクリックします。アカウント管理の組込みコンポーネントにリダイレクトする必要はありません。

アカウント管理を組み込む

Stripe ではリスクを管理する際にアカウント管理組込みコンポーネントを必要とします。このコンポーネントを、アカウントが自身の設定やプロフィールを更新するウェブサイトに組み込んでください。

アカウントセッションを作成する

アカウントセッションの作成時に、components パラメーターで account_management を指定して、アカウント管理を有効にします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[account_management][enabled]"=true \
  -d "components[account_management][features][external_account_collection]"=true

アカウント管理コンポーネントを表示する

account-management.js
JavaScript
React
No results
// Include this element in your HTML
const accountManagement = stripeConnectInstance.create('account-management');
container.appendChild(accountManagement);

// Optional:
// accountManagement.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })

このコンポーネントを使用すると、アカウントは、アカウントの詳細の更新、履行義務のある法令遵守要件への対応、認証情報の更新を行うことができます。

決済を導入する

必要な組込みコンポーネントを導入した後、決済の実装を設定します。決済と入金の組込みコンポーネントをプラットフォームに追加することや、自社のワークフローを構築することができます。

Connect Webhook を設定し、account.updated イベントをリッスンします。連結アカウントは、charges_enabled プロパティが true の場合、決済を受け付ける準備ができています。

組込み型決済機能と入金機能を導入する

payments と payouts の組込みコンポーネントを、決済システムを構築する 前に プラットフォームに追加します。これにより、連結アカウントは主要な決済ワークフローに簡単にアクセスして管理できます。

Payments コンポーネントには、連結アカウントの決済のリストが表示され、フィルタリングと個別の決済の詳細ビューが含まれます。アカウントは、このコンポーネントを使用して、返金を発行し、個別の決済に関する反証資料で不審請求の申し立てに対応できます。代わりに、完全に API 主導のカスタム決済リストを作成して維持することを選択した場合でも、Payment details コンポーネント、Disputes for a payment コンポーネント、または Stripe の API を使用して、返金と不審請求の申し立てを有効にできます。

アカウントセッションを作成する

アカウントセッションの作成 時に、components パラメーターで payments を指定して、決済の組み込みコンポーネントを有効にします。payments で features パラメーターを指定することにより、決済のコンポーネントの個々の機能を有効または無効にすることができます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[payments][enabled]"=true \
  -d "components[payments][features][refund_management]"=true \
  -d "components[payments][features][dispute_management]"=true \
  -d "components[payments][features][capture_payments]"=true \
  -d "components[payments][features][destination_on_behalf_of_charge_management]"=false

連結アカウントはダイレクト支払いに関するすべての情報を表示できます。アカウントセッションの作成時に対応する機能を有効にした場合は、返金の管理、不審請求の申請の管理、支払いのキャプチャーも行うことができます。

支払いコンポーネントを表示する

アカウントセッションを作成して ConnectJS を初期化 すると、フロントエンドで決済コンポーネントをレンダリングできます。

payments.js
JavaScript
React
No results
// Include this element in your HTML
const payments = stripeConnectInstance.create('payments');
container.appendChild(payments);

// Optional: specify filters to apply on load
// payments.setDefaultFilters({
//   amount: {greaterThan: 100},
//   date: {before: new Date(2024, 0, 1)},
//   status: ['partially_refunded', 'refund_pending', 'refunded'],
//   paymentMethod: 'card',});

Payouts コンポーネントは、連結アカウントの最近の入金、現在の残高、売上が利用可能になる時期を示します。

アカウントセッションの作成時に、components パラメーターで payouts を指定して、入金の埋め込みコンポーネントを有効にします。payouts で features パラメーターを指定することにより、入金のコンポーネントの個々の機能を有効または無効にすることができます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[payouts][enabled]"=true \
  -d "components[payouts][features][instant_payouts]"=true \
  -d "components[payouts][features][standard_payouts]"=true \
  -d "components[payouts][features][edit_payout_schedule]"=true \
  -d "components[payouts][features][external_account_collection]"=true

アカウントセッションを作成して ConnectJS を初期化すると、フロントエンドで入金コンポーネントを表示できます。

payouts.js
JavaScript
React
No results
// Include this element in your HTML
const payouts = stripeConnectInstance.create('payouts');
container.appendChild(payouts);

組込みコンポーネントを実装するための実践ガイドについては、Connect 組込みコンポーネント導入のクイックスタートをご覧ください。

決済を受け付ける

連結アカウントが顧客と直接取引する場合は、ダイレクト支払いを使用します。

Stripe は、Account に対して controller.fees.payer が account に設定されていない場合に 、決済取引手数料をプラットフォームに請求します。代わりに、お客様が連結アカウントに決済取引手数料を請求する責任を負います。支払いごとにプラットフォーム手数料を指定して自動的に連結アカウントから手数料を取得できます。その際にシステムでの構築は必要ありません。

決済の受け付けには、Stripe がオンラインで提供する事前構築済みのページである Stripe Checkout の使用をお勧めします。Checkout は複数の支払い方法に対応し、顧客に最適な方法を自動的に表示します。

事前構築された UI コンポーネントである Payment Element を使用することもできます。これを埋め込むと、一度の導入で別の支払い方法を受け付けることができます。

Checkout セッションを作成する クライアント側 サーバー側

Checkout セッションは、ラインアイテム、注文金額と通貨、および受け付け可能な支払い方法など、Stripe のオンライン決済ページで顧客に表示する内容を制御します。ダイレクト支払いを実行するとき、Checkout では連結アカウントのブランディング設定を使用します。詳細については、ブランディングをカスタマイズするセクションをご覧ください。

デスティネーション支払いや支払いと送金別方式とは異なり、ダイレクト支払いの不審請求の申請に対処する責任は、連結アカウントが負います。プラットフォームは責任を負いません。

Checkout セッションを作成するには、サーバー側のエンドポイントを呼び出す決済ボタンをウェブサイトに追加します。

checkout.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Pay</button>
    </form>
  </body>
</html>

サーバー側で、Stripe API に以下の呼び出しを行います。Checkout セッションを作成したら、レスポンスで返された URL に顧客をリダイレクトします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d mode=payment \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "payment_intent_data[application_fee_amount]"=123 \
  --data-urlencode success_url="https://example.com/success"
  • line_items - このパラメーターは、顧客が購入し、オンラインのユーザインターフェイスに表示されるアイテムを表します。
  • success_url: この引数は、支払いを完了した顧客のリダイレクト先を示します。
  • Stripe-Account: このヘッダーは、連結アカウントのダイレクト支払いを示します。ダイレクト支払いの場合、連結アカウントは Stripe 手数料、返金、およびチャージバックに対する責任を負います。Checkout では連結アカウントのブランディングが使用されるため、プラットフォームではなく連結アカウントと直接やり取りしているような印象を顧客に与えることができます。
  • (オプション) payment_intent_data[application_fee_amount] - この引数は、プラットフォームが取引から受け付ける予定の金額を指定します。連結アカウントで支払いが処理された後、application_fee_amount がプラットフォームに送金され、連結アカウントの残高から Stripe 手数料が差し引かれます。

支払い後のイベントを処理する サーバー側

支払いが完了すると、Stripe は checkout.session.completed イベントを送信します。Webhook を使用してこれらのイベントを受信し、顧客への注文確認メールの送信、データベースへの売上記録の登録、配送ワークフローの開始などのアクションを実行します。

クライアントからのコールバックを待つのではなく、これらのイベントをリッスンします。クライアント側では、コールバックの実行前に顧客がブラウザーのウィンドウを閉じたり、アプリケーションを終了したりする可能性があります。また、一部の支払い方法では支払いの確定までに 2 ～ 14 日かかることがあります。実装で非同期イベントをリッスンするように設定すると、1 つの実装で複数の支払い方法に対応できるようになります。

Checkout で支払いを回収するときは、checkout.session.completed イベントの処理に加えて、以下の 2 つのイベントも処理することをお勧めします。

イベント説明次のステップ
checkout.session.completed顧客が Checkout フォームを送信して、支払いを正常に承認しました。支払いの成功または失敗の結果を待ちます。
checkout.session.async_payment_succeeded顧客の支払いが成功しました。購入された商品やサービスのフルフィルメントを行います。
checkout.session.async_payment_failed何らかの理由により決済が拒否されたか、失敗しました。顧客にメールで連絡して、新たに注文するように依頼します。

これらのイベントのすべてに、Checkout Session (Checkout セッション) オブジェクトが含まれています。支払いが成功すると、基となる PaymentIntent のステータスが processing から succeeded に変わります。

連結アカウントへのメール通信を設定する

Stripe は、お客様の代理として連結アカウントとやり取りし、リスク管理と継続的なコンプライアンスの確保を担います。お客様は、メールドメインとプラットフォームのブランディングでこれらのメール通信のブランドをカスタマイズすることができます。

Stripe は連結アカウントに以下のメールを送信します。

  • アカウントに関するメールは、メールアドレス、電話番号、銀行口座の追加や変更など、アカウントの情報を確認します。
  • 法令順守に関するメールは、必要な情報を提供するようアカウントに通知します。Stripe は、金融パートナーに関連する規制を順守するために追加情報を収集しなければならないことがよくあります。
  • リスクメールは、リスクレビュー中のアカウントに送信されます。このメールには通常、リスクアクションの解決に関する情報 (入金の一時停止を解除する方法など) を送信するための手順が記載されています。
  • 税金に関するメール (Stripe が Stripe 手数料を連結アカウントから直接回収する場合のみ)は、タックス請求書または 1099 申告書のダウンロードが可能になったことをユーザーに通知します。

支払い関連のその他のメールを連結アカウントに送信する必要のある場合は、お客様自身で送信する必要があります。たとえば、新たな不審請求の申請に関するメールを送信するには、連結アカウントの charge.dispute.created イベントをリッスンします。そのイベントが発生したら、Disputes API を使用して詳細を取得し、アカウントにメールで送信します。

Stripe のメール通信にアカウントが応答するためのリンクを含めることができるように、決済とアカウントワークフローの URL で Connect 設定を更新する必要があります。本番環境で AccountSession または AccountLink を作成する前に、これらのリンクを更新する必要があります。

メールリンクからのリダイレクトを処理する

Stripe から送信される行動喚起を含むメールには、その行動へのリンクを含める必要があります。たとえば、連結アカウントでの行動を指示するメールを送信する場合、そのメールにはアカウント管理コンポーネントへのリンクを含める必要があります。

本番環境のアカウントセッションを作成するには、事前に、埋め込みコンポーネントをウェブサイトに組み込んだ場所の URL を指定する必要があります。 プラットフォームの Connect の設定のサイトのリンクセクションで、送信元のメールドメインと埋め込みコンポーネントの URL を設定します。

メモ

テスト環境では、本番環境と同じ URL を使用します。

サイトに組み込まれた埋め込みコンポーネントの場合は、はいを選択し、コンポーネントをホストするページの URL を入力します。埋め込みコンポーネントで処理されないアクションについては、いいえを選択し、アカウントがそのアクションを実行できるサイトのページの URL を入力します。 URL を入力したら、正しいページが開くかテストして検証します。

以下の URL を設定する必要があります。

  • 通知バナー
  • アカウント管理
  • 支払い
  • 入金
  • 残高
  • 書類 (Stripe が Stripe 手数料を連結アカウントから直接回収する場合)

メールを送信する際、 Stripe は連結アカウントの ID を stripe_account_id パラメーターとしてリダイレクト URL に自動的に追加します。このパラメーターを使用して、アカウントを識別し、認証済みであることを確認します。パラメーターを読み取り、正確な埋め込みコンポーネントを表示するためのルートをサーバー上に設定します。

Stripe での連結アカウント向けメール通信の設定について詳しくは、埋込型 Connect 連携でのメール通信をご覧ください。

メールのブランディングと設定を構成する

Stripe は、プラットフォームのブランド設定を反映したメールを、お客様のメールドメインから連結アカウントに送信できます。Stripe で連結アカウント向けのメール通信を設定するには、プラットフォームのダッシュボードのメールをご覧ください。

本番環境への移行

この時点では、以下を使用してプラットフォームの連携が完了しています。

  • 正しい設定で作成された連結アカウント
  • 連結アカウントがウェブサイトでアカウント登録、アカウントの管理、リスクアクションへの対応を行えるように統合された埋め込みコンポーネント
  • プラットフォーム手数料を設定してダイレクト支払いを使用する支払いを設定する
  • ブランド名の入ったメール通信を設定して、Stripe がコンプライアンス、リスクアクション、必要書類についてユーザーと通信できるようにする

実装内容をテストする

プラットフォームに導入された埋め込みアカウント登録を使用して、アカウント作成フローをテストします。連結アカウントの支払い方法の設定をテストするには、いずれかのテストアカウントにログインし、支払い方法の設定に移動します。テストキーとテストアカウントを使用して、決済フローをテストします。テストカードを使用して決済フローをテストし、さまざまな支払い結果をシミュレーションすることができます。