ErsatzangebotePrivate Vorschau

Erfahren Sie, wie Sie mit Ersatzfinanzierungsangeboten umgehen.

Private Vorschau

Finanzierungsangebote für Ersetzungen sind nicht standardmäßig aktiviert. Wenn Sie Ihre Integration aktualisiert haben, um Ersetzungen zu unterstützen, müssen Sie uns kontaktieren, um sie zu aktivieren.

Die Capital-Finanzierungsanwendung bietet Nutzer/innen verbundener Konten die Möglichkeit, Daten von Drittanbietern zu verknüpfen, um aktualisierte Angebotsbedingungen, beispielsweise eine höhere Kreditsumme, zu erhalten. Finanzierungsangebote für Ersetzungen bieten eine Plattform, die den Nutzern einen Einblick in die Angebotshistorie gibt.

Wenn ein Konto ein Angebot mit neuen Bedingungen erhält, aktualisiert Stripe das bestehende FinancingOffer-Objekt. Die Plattform kann nicht auf Datensätze früherer Angebote zugreifen.

Wenn Ersetzungen aktiviert sind, erstellt Stripe stattdessen ein FinancingOffer-Objekt erstellt, das das neue Angebot darstellt. Die Plattform kann sowohl auf die bestehenden als auch auf die neuen Angebote zugreifen.

Das folgende Beispiel zeigt, wie ein/e Nutzer/in ein Ersatzangebot erhalten könnte:

Stripe erstellt für den Nutzer/die Nutzerin ein nicht zugestelltes Finanzierungsangebot mit einem maximalen Kreditbetrag von 5.000 $.
Ihre Plattform sendet dem Nutzer/der Nutzerin eine Angebots-E-Mail und kennzeichnet das Angebot als zugestellt.
Der/die Nutzer/in navigiert zur Capital-Finanzierungsanwendung und verknüpft sein/ihr Bankkonto.
Stripe entscheidet, dass der/die Nutzer/in Anspruch auf einen neuen maximalen Kreditbetrag von 10.000 $ hat.
Stripe ersetzt das ursprüngliche Angebot des Nutzers/der Nutzerin über 5.000 $ durch ein neues Angebot über 10.000 $.

In diesem Leitfaden erfahren Sie, wie Sie mit einem Ersatzangebot umgehen. Es wird davon ausgegangen, dass Sie die API-Einrichtungsanleitung abgeschlossen haben.

Zugestelltes Testangebot erstellen

Rufen Sie in einer Sandbox das Capital-Dashboard auf, um ein neues Finanzierungsangebot zu Testzwecken mit dem Status „Zugestellt“ zu erstellen.

Angebot ersetzen

Klicken Sie auf das Überlaufmenü () neben dem zugestellten Angebot und wählen Sie Angebot ersetzen aus.

Notiz

Angebot ersetzen wird nur für Angebote angezeigt, die noch nie ersetzt wurden und den Status „Nicht zugestellt“ oder „Zugestellt“ haben.

Klicken Sie unten im Modal auf Ersetzen, um das Angebot zu ersetzen.

Stripe sendet den Webhook capital.financing_offer.replacement_created, nachdem ein Ersatz-Finanzierungsangebot erstellt wurde. Der Haupttext des Webhooks enthält Details zum Ersatzfinanzierungsangebot.

{
    "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",
            ...
        }
    }
}

Beachten Sie, dass das Ersatzangebot den Status „Zugestellt“ hat. Wenn ein/e Nutzer/in ein Ersatzangebot erhält, wird dieses zu seinem/ihrem aktuell aktiven Angebot.

Aktualisieren Sie Ihre Webhook-Integration, um den Webhook capital.financing_offer.replacement_created zu verarbeiten. Wenn Ihre internen Datenmodelle die aktive Finanzierungsangebots-ID des Nutzers/der Nutzerin speichern, müssen Sie sicherstellen, dass die ID auf das Ersatzangebot des Nutzers/der Nutzerin aktualisiert wird.

Das ersetzte Angebot abrufen

Nach Ersetzen des Angebots werden Sie auf eine Seite mit Details zum Ersatzangebot weitergeleitet. Die Ereignistabelle enthält das Ereignis Konto acct_egg678 hat ein Ersatzfinanzierungsangebot für financingoffer_abc123, das einen Verweis auf die ursprüngliche Angebots-ID des Nutzers/der Nutzerin bereitstellt.

Abrufen des financingoffer_abc123. Beachten Sie, dass es den Status „Ersetzt“ aufweist und das Attribut replacement den Wert financingoffer_xyz456 hat, was darauf hinweist, dass financingoffer_abc123 durch financingoffer_xyz456 ersetzt wurde.

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

„Ersetzt“ ist ein endgültiger Status. Wenn der/die Nutzer/in sein/ihr Ersatzangebot annimmt, wirken sich alle zukünftigen Statusänderungen des Angebots auf das Ersatzangebot aus.