更新非公開プレビュー

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

プライベートプレビュー

融資オファーの置き換えは、デフォルトでは有効になっていません。置き換えをサポートするようにシステムを更新した後、置き換えを有効にするには、Stripe に問い合わせる必要があります。

Capital で融資を申請すると、連結アカウントのユーザーは、サードパーティーのデータをリンクして最新のオファー条件 (ローン金額の引き上げなど) を受け取ることができます。融資オファーを置き換えることで、プラットフォームはユーザーのオファー履歴を閲覧できます。

置き換えが利用できない場合、アカウントが新しい条件のオファーを受け取ると、Stripe は既存の FinancingOffer を更新します。プラットフォームは、以前のオファーの記録にアクセスすることはできません。

置き換えを有効にすると、Stripe は代わりに新しいオファーである FinancingOffer オブジェクトを作成します。プラットフォームは、既存のオファーと新しいオファーの両方にアクセスできます。

次の例は、更新後のオファーがユーザーにどのように届くかを示しています。

Stripe が最大融資額 $5,000 で、未提供のユーザー向けの融資オファーを作成します。
プラットフォームがユーザーにオファーのメールを送信し、オファーを提供済みとしてマークします。
ユーザーは Capital の融資アプリケーションに移動して銀行口座を関連付けます。
ユーザーが最大 $10,000 の新規融資の対象であると Stripe が判定します。
Stripe はユーザーの元の $5,000 のオファーを新しい $10,000 のオファーに更新します。

このガイドでは、オファーの更新方法について説明します。API 設定ガイドを完了していることを前提として説明しています。

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

サンドボックスで Capital ダッシュボードにアクセスし、ステータスが delivered の新しいテスト用融資オファーを作成します。

オファーを更新する

配信済みオファーの横にあるオーバーフローメニュー () をクリックし、オファーの置き換えを選択します。

注

オファーを更新するは、それまでに更新が行われたことがなく、ステータスが未提供または提供済みのオファーにのみ表示されます。

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

融資オファーの更新が作成された後に、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_xyz456 で financingoffer_abc123 が更新されたことが示されます。

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

更新済みは最終ステータスです。ユーザーが更新後のオファーを受け入れた場合、その後のステータスの変化は更新後のオファーに反映されます。