更新非公開プレビュー

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

Capital の融資アプリケーションでは、サードパーティーのデータをリンクして、融資額の増額など。オファー条件の更新を受信するオプションがあります。ユーザーが新しい条件のオファーを受信すると、Stripe は融資オファーの更新を作成します。

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

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

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

ベータ

Capital API プラットフォームのデフォルトでは更新は有効化されていません。実装を更新してオファーの更新に対応できるようにしてから、有効化の方法を Stripe にお問い合わせください。

テスト環境で提供済みオファーを作成する

テスト環境でダッシュボードから、ステータスを提供済みにして新しい融資オファーを作成します。

オファーを更新する

提供済みオファーに対応する行の末尾にある 3 ドットのメニューをクリックして、オファーを更新するオプションを選択します。

注

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

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

融資オファーの更新が作成された後に、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",
  ...
}

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