ErsatzangebotePrivate Vorschau

Erfahren Sie, wie Sie mit Ersatzfinanzierungsangeboten umgehen.

Die Capital-Finanzierungsanwendung bietet Nutzer/innen die Möglichkeit, Daten von Drittanbietern zu verknüpfen, um aktualisierte Angebotsbedingungen, beispielsweise eine höhere Kreditsumme, zu erhalten. Wenn ein/e Nutzer/in ein Angebot mit neuen Bedingungen erhält, erstellt Stripe ein anderes Finanzierungsangebot.

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.

Beta

Ersetzungen sind für Capital API-Plattformen nicht standardmäßig aktiviert. Nachdem Sie Ihre Integration aktualisiert haben, um Ersatz zu unterstützen, kontaktieren Sie uns, um sie zu aktivieren.

Ein zugestelltes Angebot im Test-Modus erstellen

Erstellen Sie im Dashboard ein neues Finanzierungsangebot mit dem Status „Zugestellt“ im Test-Modus.

Angebot ersetzen

Klicken Sie auf das Menü mit den drei Punkten am Ende der Zeile, die dem zugestellten Angebot entspricht, und wählen Sie die Option 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.