更新公開プレビュー

融資オファーの更新を処理する方法をご紹介します。

公開プレビュー

Capital for platformsはpublic previewで利用できます。登録して参加してください。

Capital ファイナンスアプリケーションを使用すると、連結アカウントはサードパーティーデータをリンクして、融資金額の増加など、更新された融資オファー規約を受け取ることができます。融資オファーの交換により、プラットフォームは連結アカウントのオファー履歴を把握できます。このガイドでは、融資オファーの交換を管理する方法について説明します。

置き換えがない場合、アカウントが新しい規約のオファーを受け取ると、Stripe は既存のFinancingOfferを更新します。プラットフォームは以前のオファーの記録にアクセスできません。置き換えがある場合、Stripe は新しいオファーを表すFinancingOfferオブジェクトを作成し、プラットフォームは既存のオファーと新しいオファーの両方にアクセスできるようにします。

次の例は、連結アカウントが更新後のオファーをどのように受け取るかを示しています。

Stripe が最大融資額 5,000 USD で、連結アカウント向けの未配信の融資オファーを作成します。
プラットフォームが連結アカウントにオファーのメールを送信し、オファーを提供済みとしてマークします。
連結アカウントは Capital の融資申し込みに移動して銀行口座をリンクします。
Stripe は、連結アカウントが 10,000 USD の新しい融資限度額の対象であると判断しました。
Stripe は、連結アカウントの元の 5,000 USD オファーを新しい 10,000 USD オファーに置き換えます。

はじめに

このガイドは、API 導入を完了していることを前提としています。
融資オファーの置き換えは、デフォルトでは有効になっていません。置き換えをサポートするように導入をアップデートした後は、有効にするためにお問い合わせください。

提供済みのテスト用オファーを作成する

サンドボックスを作成するを参照してください。
ダッシュボードの Capital ページに移動します。
テストオファーを生成するには、作成をクリックしてオファー作成用のパラメーターを選択します。
- 連結アカウントの場合は、アカウントの ID を検索して既存の連結アカウントを選択するか、空のままにすると Stripe がアカウントを生成します。
- オファーの種類を選択します。追加融資の場合は、テストアカウントを選択できます。オファー条件 (金額、手数料、支払い率) を選択することもできます。
- 必要に応じて、Stripe ダッシュボードで新しい連結アカウントを作成します。
- テストオファーの場合、銀行口座をリンクする必要はありません。
- 新しく作成した連結アカウント (https://dashboard.stripe.com/test/connect/accounts/:merchant_id) の詳細を表示します。
融資オファーを作成　をクリックしてオファー作成を確定する前に、まずオファーのステータスを delivered に設定します。これは、テストのためにメールで実際にオファーを提供する必要はないからです。
融資オファーを作成をクリックして、テスト用の連結アカウント向けのオファーを作成します。
その結果、テスト用の融資オファーが配信されます。ダッシュボードのFinancing Reportingページで連結アカウントの各融資オファーを確認できます。指標は、Financing Overviewページで確認できます。

オファーを更新する

配信済みオファーの横にあるオーバーフローメニュー () をクリックし、オファーの置き換えを選択します。
注
オファーを置き換える は、それまでに置き換えが行われたことがなく、ステータスが未配信または配信済みのオファーにのみ表示されます。

モーダル下部にある 更新する をクリックして、オファーを更新します。

融資オファーの更新が作成された後に、Stripe は capital.financing_offer.replacement_created Webhook を送信します。Webhook の本文には更新後の融資オファーの詳細が含まれます。

{
    "type": "capital.financing_offer.replacement_created",
    "data": {
        "object": {
            "id": "financingoffer_xyz456",
            "object": "capital.financing_offer",
            "account": "acct_efg678",
            "status": "delivered",
            "financing_type": "flex_loan",
            "offered_terms": {
                "currency": "usd",
                "advance_amount": 100000,
                "fee_amount": 10000,
                "withhold_rate": 0.15,
            },
            "replacement_for": "financingoffer_abc123",
            ...
        }
    }
}

更新後のオファーには提供済みのステータスが設定されています。連結アカウントが更新後のオファーを受信すると、最新のアクティブオファーになります。

Webhook の導入を更新して、capital.financing_offer.replacement_created Webhook が処理されるようにします。内部のデータモデルに連結アカウントのアクティブな融資の ID が保存されている場合は、その ID を連結アカウントの置き換えオファーに更新してください。

更新後のオファーを取得する

オファーを更新すると、更新後のオファーの詳細が表示されたページにリダイレクトされます。イベントテーブルには、イベント Account acct_egg678 has a replacement financing offer for financingoffer_abc123 (アカウント acct_egg678 には financingoffer_abc123 の更新融資オファーがあります) が記載され、ユーザーの元のオファー ID への参照が提供されます。

financingoffer_abc123を取得します。ステータスが置き換え済みで、replacement属性の値が financingoffer_xyz456 になり、financingoffer_abc123 が financingoffer_xyz456 に置き換えられたことが示されます。

{
  "id": "financingoffer_abc123",
  "object": "capital.financing_offer",
  "status": "replaced",
  "replacement": "financingoffer_xyz456",
  ...
}

置き換え済みは最終テータスです。連結アカウントが置き換え後のオファーを受け入れた場合、その後のすべてのオファーステータスの変化は置き換え後のオファーに反映されます。

参照情報

API 導入のセットアップ