コンテンツにスキップ
アカウント作成/サインイン
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-11-17.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 を返します)。

onApplicationStepChange タイプ

onApplicationStepChange タイプは connect.js で定義されます。連結アカウントが Capital の申し込みプロセスでステップ間を移動するたびに、ステップ変更ハンドラーは、次のプロパティを持つ onApplicationStepChange オブジェクトを受け取ります。

氏名
タイプ
サンプル値
step
string (有効なステップ名を指定してください)
business_type
アカウント登録ステップへの一意の参照。

ステップ名

アカウント登録フローの各ページには、以下のステップ名のいずれかが設定されています。

ステップ名詳細
stripe_user_authenticationStripe がホストするウィンドウを使用してユーザー認証を処理し、本人確認を行い、融資ワークフローを保護します。
offer_selector連結アカウントに融資の申し込みを紹介し、オファーと融資の概要を説明します。
offer_summary主な条件など、融資オファーの詳細なサマリーを表示します。
business_detailsビジネスの住所、業種、業務の詳細など、連結アカウントのビジネスに関する詳細情報を収集します。
business_verification連結アカウントの事業体の存在と正当性を確認するための書類と情報を収集します。
business_summaryユーザー登録中に送信されたすべてのビジネス関連情報をレビューし、連結アカウントが詳細を確認または更新できるようにします。
owners融資に申し込むビジネスの受益者に関する情報を収集します。
directors該当する場合、ビジネスの取締役に関する詳細を収集します。
executivesビジネスに関連する主要な役員に関する情報を収集します。
representative_details融資申し込みでビジネスを代表する個人に関する情報を収集します。
representative_additional_document連結アカウントが代表者の本人確認または権限を確認する補足書類をアップロードできるようにします。
representative_document政府発行の身分証明書または同等の書類を収集し、ビジネスの代表者の本人確認を行います。
person_summary提出されたすべての個人レベルの情報 (オーナー、代表者、役員) をレビューし、更新や修正を可能にします。
offer_annual_revenue連結アカウントの年間収益に関する情報を収集して、融資の利用資格と条件を評価します。
offer_financial_data融資オファーのリスク評価と承認に必要な追加の財務書類とデータをリクエストします。
offer_missing_contact_info連結アカウントに、融資の申し込みに関連する不足している連絡先情報の提供または更新を求めます。
offer_payout_details決済と入金の詳細を収集して、連結アカウントの銀行口座への融資資金の入金を容易にします。
lending_network_offer_review_agreementsレビューと承認のために、Stripe の Lending Network を通じて調達された融資オファーに固有の契約を連結アカウントに提供します。
offer_review_agreements選択した融資オファーに関連する法務契約と条件を提示して、連結アカウントによるレビューと承認を求めます。
offer_complete融資オファーが送信され、申し込みプロセスが完了したことを確認します。

ステップの制限

  • StepChange オブジェクトは分析専用です。
  • ステップは任意の順序で表示でき、繰り返す場合があります。
  • 有効なステップ名のリストは、予告なく変更される場合があります。

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

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

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

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

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

参照情報