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

注

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

Capital 申し込みコンポーネント公開プレビュー

Capital 融資のエンドツーエンドの申し込みフローを表示します。

Capital アプリケーションコンポーネントを使用すると、対象となる連結アカウントは、プラットフォームのウェブサイトまたは申し込みで融資の申し込みを完了できます。連結アカウントは、オファーの金額と規約を選択し、契約の詳細を表示し、申し込みを送信できます。

このコンポーネントは Capital プロモーションコンポーネントに似ていますが、アプリケーションを直接呼び出し、教育的またはプロモーション用のコンテンツは含まれません。適格な接続アカウントに対して、融資オファーやプログラム情報の表示方法をカスタマイズしたい場合は、この組み込みコンポーネントを使用してください。

はじめに

Capital 埋め込みコンポーネントをインストールする

Stripe SDK (ベータバージョン) をインストールして、非公開プレビュー版のコンポーネントのアカウントセッションを作成します。

Stripe のクライアント側ライブラリ (ベータバージョン) を使用して、非公開プレビュー版のコンポーネントをレンダリングします。

ライブラリをインストールします。

npm install --save @stripe/connect-js@preview

アプリケーションで React を使用している場合は、以下のようにします。

npm install --save @stripe/react-connect-js@preview

Connect.js を設定する

アプリケーションでまだ Stripe の組み込みコンポーネントを使用していない場合は、アプリケーションコンポーネントを導入する前に Connect.js を初期化します。

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

アカウントセッションの作成リクエストで、componentsパラメーターにcapital_financing_applicationを指定します。

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-09-30.clover; embedded_connect_beta=v2;" \
  -d account=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "components[capital_financing_application][enabled]"=true

アプリケーションコンポーネントを表示する

Capital のアプリケーションコンポーネントをフロントエンドに表示します。

capital-financing-application.js
JavaScript
React
No results
// Include this element in your HTML
const capitalFinancingApplication = stripeConnectInstance.create('capital-financing-application');
container.appendChild(capitalFinancingApplication);
メソッドタイプ説明デフォルト
setOnApplicationSubmitted() => void連結アカウントで融資の申し込みが正常に送信されました。
setOnApplicationStepChange({step: string}) => void連結アカウントがアプリケーションを操作しました。
setPrivacyPolicyUrlstringプライバシーポリシーが記載されたページの絶対 URL。https://stripe.com/privacy
setHowCapitalWorksUrlstringCapital プログラムに関する情報が掲載されたページの絶対 URL。https://docs.stripe.com/capital/how-capital-for-platforms-works

表示状態を設定する

プラットフォームの UI で、連結アカウントが決済および入金レポート情報の表示に使用するページ、または専用の融資ページにアプリケーションコンポーネントを追加します。Connect プロモーションコンポーネントとは異なる場所を使用してください(該当する場合)。

連結アカウントがオファーの対象かどうかを判断するには、Listfinancing offersエンドポイントを呼び出し、connected_accountパラメーターで連結アカウント ID を渡します。

アプリケーションコンポーネントは、連結アカウントの融資ステータスに基づいて動的にコンテンツを表示します。

  • 有効な融資なし: アカウントに対象となる融資オファーがない場合、アプリケーションコンポーネントは表示されません (null を返します)。

  • 有効なオファーがある場合: 連結アカウントがオファーの対象である場合、コンポーネントには申し込みを開始ボタンとともにオファーの詳細がすべて表示されます。

  • 審査中のオファー: 対象となる連結アカウントが融資オファーを受け入れて申請した後、この状態を使って申請状況トラッカーを表示します。オファーの進行状況を追跡するには、onApplicationStepChangeイベントを監視してください。このイベントは、接続アカウントが次のステップに進むか、あるいは前のステップやページに戻ったときに発生します。次のステップの名前は、Capital アプリケーションプロセスで指定したハンドラーに渡されます。ステップは任意の順序で現れることがあり、繰り返される場合もあります。ステップ名はいつでも変更、追加、削除できます。

    onApplicationStepChangeオブジェクトは、平均ページ完了時間の追跡や離脱が多いページの分析など、分析目的でのみ使用してください。特定のページで申請を中断した接続アカウントにメールを送るなど、運用やサポートのワークフローをトリガーするためにonApplicationStepChangeを使用してはいけません。

  • 送信済みのオファー: 連結アカウントがすでに融資申し込みを送信している場合、Capital 融資申し込みコンポーネントは空の画面を表示します。代わりにonApplicationSubmitted イベントを監視し、確認画面を表示することをお勧めします。

  • 進行中の有効な融資: コンポーネントは表示されません (null を返します)。

コンポーネントを送信してレビューを受ける

本番環境で Capital コンポーネントを使用するには、Stripe と金融パートナーは、Stripe Capital を参照するすべての顧客向けコンテンツをレビューおよび承認する必要があります。

  1. サンドボックスでテストオファーを作成し、オファーのステータスを提供済みに設定します。このテストオファーを使用して、プラットフォームのウェブサイトまたはダッシュボードでアプリケーションコンポーネントをプレビューします。
  2. サンドボックスオファーのプレビューと、組み込みコンポーネントがプラットフォームの UI にどのように表示されるか (スクリーンショットや録画されたビデオなど) をキャプチャーします。
  3. プレビューを Stripe に送信します。承認後、Stripe は本番環境でコンポーネントを使用できるようにします。

オプションその他の埋め込みコンポーネント

アプリケーションコンポーネントは、プラットフォーム向けの Capital で利用できるいくつかの組み込みコンポーネントの 1 つです。たとえば、Capital 融資コンポーネントを組み込むことで、連結アカウントが決済を管理し、取引履歴を表示できるようになります。

参照情報

このページはお役に立ちましたか。
はいいいえ