すべてのプラットフォームが Accounts API の Webhook イベントを介して、連結アカウントのリスクに関連する要件についての一貫したインサイトを得ることができます。利用規約のリクエスト、アカウントの閉鎖の保留など、規制順守とリスク関連のすべての要件を API を利用して監視し、プログラムで管理することができます。詳細については、API ドキュメントをご覧ください。
今回の変更によるお客様への影響
新しいリスク要件についての account.updated Webhook イベントがトリガーされた場合に顧客に送信する通知 (メール、プッシュ通知) によって、連結アカウントが解決のために適切な Stripe UI またはコンポーネントに確実に導かれるようにする必要があります。引き続き、API レスポンスを介して規制要件に対応することもできます。
新しいリスク要件については、以下のいずれかの対応方法を採用してください。
Connect 埋め込みコンポーネント: Connect コンポーネントを自社のウェブサイトに直接埋め込みます。要件が表示された場合、ユーザーをアカウント登録の埋め込みコンポーネントに導きます。そこで、ユーザーは未解決の要件を直接 UI に入力するように求められます。あるいは、通知バナー埋め込みコンポーネントを使用して、ユーザーにメッセージを表示します。
Stripe のホスティング登録: 未解決の要件を Stripe のホスティング登録ページで入力できるように、リンクを生成して連結アカウントを誘導します。アカウントリンクをプログラムで生成することも、ダッシュボードからホスティング登録のリンクを手動で生成することもできます。
アカウントの代理で入力する: ダッシュボードを使用して、連結アカウントの詳細ページでフォームベースのリスク要件を見つけて、アカウントの代理で入力することができます。
account.updated Webhook でトリガーされる自動アクションをすべて確認し、必要に応じて、変更点についてユーザーから質問があった場合に備えてサポートチームを準備することをお勧めします。
新しい API の機能をテストするにはどうすればよいですか？
右上にあるトグルを使ってダッシュボードをテスト環境に切り替えます。
既存の連結アカウントを使用する場合は Connect ページの下部のいずれかの行をクリックし、新しい連結アカウントを作成する場合は右上にある作成ボタンをクリックします。
連結アカウントのダッシュボードにアクセスしたら、右上にあるオーバーフローメニューを開き、情報をリクエストをクリックします。
情報をリクエストをクリックすると、以下のモーダルウィンドウが開きます。
ドロップダウンから要件のオプションを選択します。許可されていない IP の物品を選択した場合、申告書要件があります。この申告書を提出すると、要件が pending_verification に移行します。Esc 慈善団体を選択すると、申告書の提出時に要件が自動的に解決されます。追加をクリックしてモーダルウィンドウを閉じ、ページを更新すると、新しい要件が表示されます。
API を使用して介入を表示する
API を使用して介入を表示すると、要件に関連付けられた current_deadline に応じて、その要件の ID がレスポンスオブジェクト内の past_due、currently_due、eventually_due のいずれかに含まれます。
{
id: "acct_123",
...
requirements: {
"alternatives": [],
"current_deadline":1709769600,
"currently_due": [
"interv_abc123.supportability.industry_diligence.form"
],
"disabled_reason": null,
"errors": [],
"eventually_due": [
"interv_abc123.supportability.industry_diligence.form"
],
"past_due": [],
"pending_verification": []
},
...
}
テスト環境の介入を解決する
accounts オブジェクトに対する要件の介入がどのように進んでいるかを確認するには、この Connect アカウントの「アカウントの詳細」ページに移動します。
必要なアクションの下にある新しいタスクをクリックすると、タスクの詳細ページが開きます。更新ボタンから直接送信するをクリックし、連結アカウントの代わりに申請書に入力します。これにより、この情報が保留中状態に移行し、この状態遷移を反映するために accounts オブジェクトが更新されます。
{
id: "acct_123",
...
requirements: {
"alternatives": [],
"current_deadline":1709769600,
"currently_due": [],
"disabled_reason": null,
"errors": [],
"eventually_due": [],
"past_due": [],
"pending_verification": [
"interv_abc123.supportability.industry_diligence.support"
]
},
...
}
このテスト環境の介入は 15 ～ 25 分で自動的に解決されます。accounts オブジェクトのリクエストを再度行うと、自動解決された結果が反映されているはずです。以下のレスポンス例をご確認ください。
{
id: "acct_123",
...
requirements: {
"alternatives": [],
"current_deadline": null,
"currently_due": [],
"disabled_reason": null,
"errors": [],
"eventually_due": [],
"past_due": [],
"pending_verification": []
},
...
}