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

注

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

Capital プロモーションコンポーネント公開プレビュー

連結アカウントの 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_promotionを指定します。

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-08-27.basil; embedded_connect_beta=v2;" \
  -d account=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "components[capital_financing_promotion][enabled]"=true

コンポーネントをレンダリングする

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

capital-financing-promotion.js
JavaScript
React
No results
// Include this element in your HTML
const capitalFinancingPromotion = stripeConnectInstance.create('capital-financing-promotion');
container.appendChild(capitalFinancingPromotion);
メソッドタイプ説明デフォルト
setOnApplicationSubmitted() => void連結アカウントで融資の申し込みが正常に送信されました。
setOnApplicationStepChange({step: string}) => void連結アカウントがアプリケーションを操作しました。
setLayoutfull | bannerコンポーネントのレイアウトを制御します。banner モードでは、コンポーネントの縦方向のサイズが大幅に縮小されるため、ページ内でコンポーネントを他のコンテンツと積み重ねる場合に便利です。full
setOnEligibleFinancingOfferLoaded({productType: standard | refill | none}) => void連結アカウントの融資オファーが読み込まれました。productType フィールドは、Financing Offer (融資オファー) オブジェクトの product_type フィールドに対応しています。
setPrivacyPolicyUrlstringプライバシーポリシーが記載されたページの絶対 URL。https://stripe.com/privacy
setHowCapitalWorksUrlstringCapital プログラムに関する情報が掲載されたページの絶対 URL。https://docs.stripe.com/capital/how-capital-for-platforms-works
setEligibilityCriteriaUrlstringCapital プログラムの利用資格基準に関する情報が掲載されたページの絶対 URL。https://docs.stripe.com/capital/how-capital-for-platforms-works

表示状態を設定する

プラットフォームのホームページにプロモーションコンポーネントを追加するか、プラットフォームのウェブサイトまたはアプリで専用の融資ページを追加します。アプリケーションコンポーネントは、連結アカウントの融資ステータスに基づいてコンテンツを動的に表示します。

  • 有効な融資はありません: 連結アカウントに有効な融資がない場合、コンポーネントには利用資格と融資プログラムに関する一般的な情報が表示されます。

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

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

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

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

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

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

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

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

参照情報

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