ErsatzangeboteÖffentliche Vorschau

Erfahren Sie, wie Sie mit Ersatzfinanzierungsangeboten umgehen.

Öffentliche Vorschau

Capital for platforms is available in public preview. Sign up to join.

Mit den Anmeldeformularen für Capital-Finanzierungen können verbundene Konten die Daten von Drittanbietern verbinden, um aktualisierte Konditionen für Finanzierungsangebote zu erhalten, z. B. einen höheren Finanzierungsbetrag. Ersetzungen von Finanzierungsangeboten verschafft Ihrer Plattform Einblick in die Angebotshistorie Ihrer verbundenen Konten. Dieser Leitfaden beschreibt, wie Sie die Ersetzung von Finanzierungsangeboten verwalten.

Ohne Ersetzungen: Wenn ein Konto ein Angebot mit neuen Konditionen erhält, aktualisiert Stripe das bestehende FinancingOffer. Ihre Plattform kann nicht auf die Aufzeichnungen früherer Angebote zugreifen. Mit Ersetzungen: Stripe erstellt ein FinancingOffer-Objekt, das das neue Angebot repräsentiert, so dass Ihre Plattform sowohl auf bestehende als auch auf neue Angebote zugreifen kann.

Das folgende Beispiel zeigt, wie ein verbundenes Konto ein Ersatzangebot erhalten könnte:

Stripe erstellt für das verbundene Konto ein noch nicht bereitgestelltes Finanzierungsangebot mit einem maximalen Kreditbetrag von 5.000 USD.
Ihre Plattform sendet dem verbundenen Konto eine E-Mail mit einem Angebot und markiert das Angebot als bereitgestellt.
Das verbundene Konto navigiert zum Capital-Finanzierungsantrag und verbindet sein Bankkonto.
Stripe bestimmt, dass das verbundene Konto für einen neuen maximalen Kreditbetrag von 10.000 USD in Frage kommt.
Stripe ersetzt das ursprüngliche Angebot von 5.000 USD für das verbundene Konto durch ein neues Angebot von 10.000 USD.

Bevor Sie loslegen

Diese Anweisung setzt voraus, dass Sie eine API-Integration abgeschlossen haben.
Die Ersetzung von Finanzierungsangeboten ist standardmäßig nicht aktiviert. Nachdem Sie Ihre Integration so aktualisiert haben, dass sie Ersatzangebote unterstützt, müssen Sie uns kontaktieren, um sie zu aktivieren.

Zugestelltes Testangebot erstellen

Erstellen Sie eine Sandbox.
Rufen Sie im Dashboard die Seite Capital auf.
Um ein Testangebot zu erstellen, klicken Sie auf Erstellen und wählen die Parameter für die Angebotserstellung aus.
- Wählen Sie als verbundenes Konto ein bestehendes verbundenes Konto aus, indem Sie nach der ID des Kontos suchen. Sie können dieses auch leer lassen, dann wird Stripe ein Konto für Sie erstellen.
- Sie können die Art des Angebots und, falls es sich um ein Refill-Angebot handelt, das Testkonto auswählen. Sie können auch die Angebotsbedingungen (Betrag, Gebühr und Zahlungsrate) auswählen.
- Wenn Sie möchten, erstellen Sie ein neues verbundenes Konto im Stripe-Dashboard.
- Bei Testangeboten müssen Sie das Bankkonto nicht verknüpfen.
- Kontodetails Ihres neu erstellten verbundenen Kontos anzeigen: https://dashboard.stripe.com/test/connect/accounts/:merchant_id.
Bevor Sie die Angebotserstellung durch Klicken auf Finanzierungsangebot erstellen abschließen, setzen Sie zunächst den Angebotsstatus auf delivered, da die tatsächliche Angebotszustellung in einer E-Mail für Tests nicht erforderlich ist.
Klicken Sie auf Finanzierungsangebot erstellen, um das Angebot für das verbundene Testkonto zu erstellen.
Das Ergebnis ist ein bereitgestelltes Testfinanzierungsangebot. Im Dashboard können Sie jedes Finanzierungsangebot für Ihre verbundenen Konten auf der Seite Finanzierungsberichte einsehen. Die Metriken können Sie auf der Seite Finanzierungsübersicht einsehen.

Angebot ersetzen

Klicken Sie auf das Überlaufmenü () neben dem zugestellten Angebot und wählen Sie Angebot ersetzen aus.
Notiz
Replace offer only appears for offers that have never been replaced and have a status of undelivered or delivered.

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 bereitgestellt hat. Wenn ein verbundenes Konto ein Ersatzangebot erhält, wird es zu seinem aktuellen aktiven Angebot.

Aktualisieren Sie Ihre webhookI-ntegration, um den Webhook capital.financing_offer.replacement_created zu verarbeiten. Wenn Ihre internen Datenmodelle die ID des aktiven Finanzierungsangebots für das verbundene Konto speichern, stellen Sie sicher, dass Sie die ID auf das Ersatzangebot für das verbundene Konto aktualisieren.

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.

Rufen Sie financingoffer_abc123 ab. Beachten Sie, dass der Status ersetzt lautet und das Attribut Ersatz den Wert financingoffer_xyz456 besitzt, was bedeutet, dass financingoffer_xyz456 financingoffer_abc123 ersetzt hat.

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

Ersetzt ist ein Datenterminal-Status. Wenn das verbundene Konto das Ersatzangebot annimmt, wirken sich alle zukünftigen Zustandsübergänge des Angebots auf das Ersatzangebot aus.

Siehe auch

Einrichten einer API-Integration