カスタムの Capital プログラムを構築する非公開プレビュー

Capital オファーを受け取るすべてのユーザー向けのオファーメール、申請、融資レポートページに、お客様のビジネス名、アイコン、ロゴ、ブランドカラーが表示されます。

**Connect ブランディング設定**に移動し、プラットフォームのブランディング設定が正しいことを確認します。

テスト環境のツールを使用して実装を構築することをお勧めします。テスト環境で Capital ダッシュボードに移動します。

1. 作成をクリックして、融資オファーを作成モーダルを開きます。ここではテスト環境で融資オファーを作成できます。デフォルトのオプションでは、1,000 USD のローン金額で未提供の融資オファーを作成します。
2. デフォルトのオプションをそのままにして融資オファーを作成をクリックします。
3. ダッシュボードで、作成したオファーに対応する行をクリックします。

連結アカウントの詳細ページの融資と資金調達セクションに、ユーザーの融資オファーの詳細が表示されます。

List financing offers (融資オファーの一覧表示) エンドポイントを使用して、プラットフォームユーザーすべての融資オファーを取得できます。

curl https://api.stripe.com/v1/capital/financing_offers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:

オファーが正常に作成されると、次のようなレスポンスが返されます。

{
  "object": "list",
  "url": "/v1/capital/financing_offers",
  "has_more": false,
  "data": [
    {
      "id": "financingoffer_abc123",
      "object": "capital.financing_offer",
      ...,
    },
    {...}
  ]
}

Retrieve financing offer (融資オファーの取得) エンドポイントを使用して、融資オファーを確認できます。上記の一覧から最初の融資オファーを取得します。

curl https://api.stripe.com/v1/capital/financing_offers/financingoffer_abc123 \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:

融資オファーが作成されると、Stripe は capital.financing_offer.created Webhook を送信します。Webhook の実装を更新して、capital.financing_offer.created Webhook をリッスンします。自社でカスタマイズしたメールを送信している場合、Webhook はユーザーにオファーを通知する重要な通知になります。

メールでは、ユーザーにプラットフォームダッシュボードの専用の Capital セクションへのリンクを提供します。ユーザーは Account Links を使用して Capital の融資申し込みにアクセスします。 Account Links は生成後、短時間で期限切れになるため、申し込みのリンクを再生成する方法をユーザーに提供します。タイプ capital_financing_offer の Account Link を生成して、プラットフォームのダッシュボードに融資申し込みへのリンクを含めます。

curl https://api.stripe.com/v1/account_links \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d account=acct_123 \
  # The URL the user will be redirected to if the account link is expired, has been previously-visited, or is otherwise invalid.
  -d refresh_url="https://example.com/reauth" \
  # The URL the user will be redirected to after completing the linked flow.
  -d return_url="https://example.com/thanks" \
  -d type=capital_financing_offer

Account Link が正常に作成されると、次のようなレスポンスが返されます。

{
  "object": "account_link",
  "created": 1611264596,
  "expires_at": 1611264896,
  "url": "https://connect.stripe.com/capital/offer/SrjgLUfa0O7K"
}

Webhook の実装を更新した後に、ダッシュボードで新たにオファーを作成し、capital.financing_offer.created Webhook が届くことを確認します。

オファーを提供済みとしてマークする

オファーのメールを送信してから、Webhook の実装を更新して、融資を提供済みとしてマークします。オファーを提供済みとしてマークすることは必須であり、オファーをユーザーに提供したという確認になります。

curl https://api.stripe.com/v1/capital/financing_offers/financingoffer_abc123/mark_delivered \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:

ダッシュボードまたは Financing Offer API を使用して、融資オファーのステータスが提供済みになっていることを確認します。

capital.financing_offer.created Webhook に加え、融資オファーが別のステータスに移行するたびに、Stripe はさらに Webhook を送信します。受信する可能性がある Webhook の詳細な一覧を次に紹介します。

ダッシュボードで、過去に提供したオファーを探します。

1. オーバーフローメニュー () をクリックします。
2. オファーを期限切れにするオプションをクリックすると、オファーの期限切れをシミュレーションできます。
3. capital.financing_offer.expired Webhook が届くことを確認します。

テスト環境のツールを使用すると、capital.financing_offer.canceled 以外のすべての Webhook をシミュレーションできます。

オファーへの申し込みを行うと、capital.financing_offer.accepted Webhook をシミュレーションすることができます。

1. ダッシュボードから、最大ローン額 20,000 USD のオファーを作成し、提供済みにします。
2. タイプ capital_financing_offer のアカウントリンクを生成して、そのリンクに移動します。そこで申請がどのようにユーザーに表示されるかをプレビューできます。
3. 申し込みの最後に到達するまで続け、送信をクリックします。
4. capital.financing_offer.accepted Webhook が届くことを確認します。
5. ダッシュボードでオファーを表示し、ステータスが受け付け済みであることを確認します。

申し込みのトラッカーを表示する

ステータスが受け付け済みの融資オファーは、Stripe のサービスチームによる審査を待っています。 この審査の実行中にユーザーを融資レポートページに転送することができます。融資レポートページには、申し込みの審査に関するタイムラインの概要が表示された申し込みのトラッカーがあります。

タイプ capital_financing_reporting の Account Link を生成します。

curl https://api.stripe.com/v1/account_links \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d account=acct_123 \
  # When the user refreshes the page, where should we redirect them
  -d refresh_url="https://example.com/reauth" \
  # When the user completes the application, where should they return
  -d return_url="https://example.com/thanks" \
  -d type=capital_financing_reporting

リンクに移動し、申し込みのトラッカーを表示します。

ダッシュボードで、受け付けたオファーに対応する行を探します。

1. オーバーフローメニュー () をクリックします。
2. 承認して資金を支払うオプションをクリックします。これにより申し込みの承認と資金の入金をシミュレーションできます。
3. 資金が支払われたことを通知する capital.financing_offer.paid_out Webhook が届くことを確認します。
4. タイプ capital_financing_reporting の Account Link を新たに生成します。これで、レポートページではユーザーの進行中の融資に関する入金と返済取引の詳細にアクセスできるようになります。
5. 支払いを行うをクリックして、支払い取引を作成します。

取引の処理後、取引の表で支払いを確認します。Financing Summary API を使用すると、進行中の融資でユーザーが返済した融資額をプログラムによって確認することができます。

curl https://api.stripe.com/v1/capital/financing_summary \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \

融資のサマリーの取得が正常に行われると、次のようなレスポンスが返されます。

{
  "object": "capital.financing_summary",
  "details": {
    "currency": "usd",
    "advance_amount": 1000000,
    "fee_amount": 100000,
    "withhold_rate": 0.2,
    "remaining_amount": 999950,
    "paid_amount": 50,
    "current_repayment_interval": {
      "due_at": 123456789,
      "remaining_amount": 50,
      "paid_amount": 50
    },
    "repayments_begin_at": 123456789,
    "advance_paid_out_at": 123456789
  }
}

ダッシュボードで、資金を供給した融資に対応する行を探します。

1. オーバーフローメニュー () をクリックします。
2. オファーを返済するオプションをクリックします。これにより、融資残高の完済をシミュレーションできます。
3. 融資が完済されたことを通知する capital.financing_offer.fully_repaid Webhook が届くことを確認します。
4. タイプ capital_financing_reporting の Account Link を新たに生成します。

ユーザーが融資を完済した後は、いつでもレポートページで過去の融資の詳細を表示できます。

ここまでで、お客様の実装は以下のようになっています。

• capital.financing_offer.created Webhook を受けて、オファーメールを送信し、オファーを提供済みとしてマークする
• プラットフォームのダッシュボードに融資申し込みのリンクを公開する
• プラットフォームのダッシュボードに融資レポートのリンクを公開する

プラットフォームのダッシュボードの Capital セクションは、ユーザーの融資の現在のフェーズに応じて表示が異なる場合があります。以下の状態図で、融資オファーに設定される可能性があるステータス値のリストをご確認ください。

本番環境で自動オファーを有効にすると、Stripe は毎日、ユーザー向けの融資オファーを自動的に作成します。自動オファーを有効にする前に、以下について確認してください。

1. コミュニケーションセンターを利用して、ユーザーのメールアドレスの確認と更新を行います。ユーザーが Capital の融資を利用するには、支払いの進捗状況の更新などの取引メールの受信できるようにするため、Stripe にメールアドレスが保存されている必要があります。
2. Financing offers API の本番環境での利用の申請をご希望の場合は、こちらにお問い合わせください。

追加機能の有効化

時間の経過とともに、追加融資の利用が可能になるユーザーも存在します。追加融資は、進行中のローンの返済がかなり進んでいるユーザーに送られる追加の融資オファーです。追加融資オファーに対応できるように構築済みのシステムを更新するには、追加融資の導入ガイドをご使用ください。

プラットフォームのダッシュボードへの Capital 取引の導入をご希望の場合は、レポート作成と照合ガイドをご確認ください。