カスタムの 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_BQokikJOvBiI2HlWgH4olfQ2
:

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

{
  "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_BQokikJOvBiI2HlWgH4olfQ2
:

融資オファーが作成されると、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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:

ダッシュボードまたは 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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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 の アカウントリンク を別途生成します。このレポートページでは、ユーザーの進行中の融資の未払い残高、入金、および支払い取引の詳細にアクセスできます。
5. 支払いを行う をクリックし、手動支払いを作成します。

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

curl https://api.stripe.com/v1/capital/financing_summary \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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. Stripe ブランド提携のノーコードオファーメールを活用する予定がある場合は、コミュニケーションセンターでユーザーのメールアドレスを確認・更新します。Capital ファイナンスの対象となるには、ユーザーが Stripe にメールを保存して、支払いの進捗状況の更新といった取引に関するメールを受信できるようにする必要があります。
2. Financing offers API の本番環境での利用の申請をご希望の場合は、こちらにお問い合わせください。

追加機能の有効化

時間の経過とともに、一部のユーザーがリフィルの対象になる場合があります。リフィルは、進行中のローンの返済が大幅に進んだユーザーに送信される追加の融資オファーです。リフィル導入ガイドに従って、リフィル融資のオファーをサポートするように連携を更新します。

プラットフォームダッシュボードに資本取引を含め、ユーザーへの入金レポートを更新する場合は、レポートと照合ガイドを参照してください。