埋め込み型 Connect 連携でのメール通信
完全埋め込み型の実装で、連結アカウントへの Stripe 通知をカスタマイズできます。
埋め込みの Connect の実装では、連結アカウントが情報を確認したり、アクションを実行したりする必要がある場合、 Stripe はメール通信をそれらのアカウントに直接送信します。これらのメールは、連結アカウントをウェブサイトの埋め込みコンポーネントに誘導して、情報を確認したり必要なアクションを実行するように促します。これらのコンポーネントの URL を Stripe に提供して、Stripe がメールにそれらのコンポーネントを含められるようにする必要があります。
Stripe が送信するメッセージをプラットフォームのブランドに合わせてカスタマイズしたり、アカウントの詳細ページでアカウントの Stripe のメール履歴を確認したりできます。
Stripe が連結アカウントに送信する通信![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe は連結アカウントに以下のメールを送信します。
- アカウントに関するメールは、メールアドレス、電話番号、銀行口座の追加や変更など、アカウントの情報を確認します。
- 法令順守に関するメールは、必要な情報を提供するようアカウントに通知します。Stripe は、金融パートナーに関連する規制を順守するために追加情報を収集しなければならないことがよくあります。
- リスクメールは、アカウントがリスク審査を受けている場合にそのアカウントに通知します。これらのメールには、多くの場合、入金の一時停止の解除など、リスクアクションを解決するために情報を送信する手順が記載されています。
- 税金に関するメール (Stripe が Stripe 手数料を連結アカウントから直接回収する場合のみ)は、納税申告書または 1099 申告書のダウンロードが可能になったことをユーザーに通知します。
支払い関連のその他のメールを連結アカウントに送信する必要のある場合は、ご自身で送信する必要があります。たとえば、新たな不審請求の申請に関するメールを送信するには、連結アカウントの charge.
イベントをリッスンします。そのイベントが発生したら、Disputes API を使用して詳細を取得し、アカウントにメールで送信します。
Stripe のメール通信に、アカウントが応答するためのリンクを含めることができるようにするため、支払いとアカウントのワークフローのURL で Connect の設定を更新する必要があります。
Web サイトコンポーネントへのサイトリンク![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe から送信される行動喚起のメールには、そのアクションを実行するためのリンクが含まれています。たとえば、リスク通知に対応するように連結アカウントにメールを送信する場合、そのメールには、通知バナーコンポーネントを埋め込んだページへのリンクが含まれます。
本番環境のアカウントセッションを作成するには、事前に、埋め込みコンポーネントをウェブサイトに組み込んだ場所の URL を指定する必要があります。 プラットフォームの Connect の設定のサイトのリンクセクションで、送信元のメールドメインと埋め込みコンポーネントの URL を設定します。
注
テスト環境環境では本番環境と同じ URL を使用します。
サイトに組み込まれた埋め込みコンポーネントの場合は、はいを選択し、コンポーネントをホストするページの URL を入力します。埋め込みコンポーネントで処理されないアクションについては、いいえを選択し、アカウントがそのアクションを実行できるサイトのページの URL を入力します。 URL を入力したら、正しいページが開くかテストして検証します。検証をクリックすると、リンクをテストできます。
以下の URL を設定する必要があります。
- 通知バナー
- アカウント管理
- 決済
- 入金
- 残高
- 書類 (Stripe が Stripe 手数料を連結アカウントから直接回収する場合)
メールを送信する際、 Stripe は連結アカウントの ID を stripe_
パラメーターとしてリダイレクト URL に自動的に追加します。このパラメーターを使用して、アカウントを識別し、認証済みであることを確認します。パラメーターを読み取り、正確な埋め込みコンポーネントを表示するためのルートをサーバー上に設定します。
通信のプレビューとカスタマイズ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe が連結アカウントに送信する提携ブランドの通信は、通信設定でカスタマイズできます。メールのカテゴリーをカスタマイズするには、プレビューしてカスタマイズするをクリックします。
メールブランディングをカスタマイズする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ビジネス名、ロゴ、アイコン、ブランドカラー、アクセントカラーを設定できます。 Stripe は、連結アカウントに送信する提携ブランドメールにこれらの値を使用します。
メールドメインをカスタマイズする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
デフォルトでは、メールは stripe.com アドレスから送信されます。ドメインのカスタマイズはできますが、特定のアドレスはカスタマイズできません。アドレスはメッセージのコンテキストに基づいて自動的に設定されます。
メールのプレビューとテスト![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ブランド提携の Stripe メールのカテゴリーをカスタマイズすると、ページの右側のプレビューでデザインを確認して、リンクをテストできます。プレビュードロップダウンリストから特定のメールを選択します。**Send email (メールを送信)**をクリックして、テストメールを送信し、正しく機能していることを確認することもできます。
連結アカウントに送信されたメールの履歴を確認する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe が連結アカウントに送信したメールは、アカウントの詳細ページの Emails to this account (メール送信先のアカウント) で確認できます。正確な内容、宛先アドレス、ステータス (たとえば、送信に成功したか、開封されたか) などのメールの詳細を確認するには、リストでそのメールをクリックします。