RefillsPrivate Vorschau

Erfahren Sie, wie Sie Refills für Ihr Capital-Programm aktivieren.

Bei Refills handelt es sich um zusätzliche Finanzierungsangebote, die an Kundinnen und Kunden gesendet werden, die erhebliche Fortschritte bei der Rückzahlung ihrer laufenden Kredite gemacht haben. Im Falle einer Genehmigung wird bei Refill-Angeboten der Restbetrag des laufenden Kredits zurückgezahlt.

In diesem Leitfaden wird davon ausgegangen, dass Sie die API-Einrichtungsanleitung abgeschlossen haben.

Private Vorschau

Refills sind für Capital API-Plattformen nicht standardmäßig aktiviert. Nachdem Sie Ihre Integration aktualisiert haben, um Refills zu unterstützen, kontaktieren Sie uns, damit wir Refill-Angebote für Ihre Plattform aktivieren.

Lebenszyklus von Refill-Angeboten

Stripe prüft täglich den Anspruch von aktiven Capital-Nutzer/innen auf Refill-Finanzierung, genau wie bei Standardfinanzierungsangeboten.
Wenn ein Refill-Angebot erstellt wird, erhalten Sie den Webhook capital.financing_offer.created, der "product_type": "refill" enthält, um anzugeben, dass es sich um ein Refill-Angebot handelt.
Abhängig von den Feldern product_type und offered_terms.campaign_type verwenden Sie genehmigte Nachrichten, um die Kundin/den Kunden über das Finanzierungsangebot zu informieren.
Kundinnen und Kunden greifen über den Konto-Link aus dem API-Einrichtungsleitfaden auf den Refill-Antrag zu. Anschließend können diese über einen individuellen Schieberegler den Betrag bis zum maximal möglichen Angebotsbetrag festlegen.
Refill-Antrag
Refill-Antrag
Kundinnen und Kunden, die das Refill-Angebot annehmen, kann ein Rabatt in Form eines Prozentsatzes auf die verbleibende Prämie ihres bestehenden Darlehens angeboten werden. Dieser Abzinsungssatz wird unter offered_terms als previous_financing_fee_discount_rate ausgewiesen.

Wenn der Kunde/die Kundin das Refill-Angebot annimmt, senden wir den Webhook capital.financing_offer.accepted. Die Webhook-Nutzlast enthält das Feld accepted_terms mit den vom Kunden/von der Kundin ausgewählten Beträgen. Das Feld previous_financing_fee_discount_amount ist null, bis die vorherige Finanzierung vollständig zurückgezahlt wurde und wir den Rabattbetrag ermittelt haben. Wenn kein Rabatt vorhanden ist, bleibt previous_financing_fee_discount_amount auch dann null, wenn die vorherige Finanzierung vollständig zurückgezahlt wurde.

Beispiel-Webhook:

{
    "type": "capital.financing_offer.accepted",
    "api_version": "2022-02-28",
    "created": 123456789,
    "data": {
        "object": {
            "id": "financingoffer_abcdef123456",
            "object": "capital.financing_offer",
            "account": "acct_abcdef123456",
            "created_at": 123456789,
            "expires_after": 123456789,
            "livemode": true,
            "status": "accepted",
            "accepted_terms": {
                "currency": "usd",
                "advance_amount": 100000,
                "fee_amount": 10000,
                "withhold_rate": 0.15,
                "previous_financing_fee_discount_amount": null
            },
            "financing_type": "flex_loan",
            "offered_terms": {
                "currency": "usd",
                "advance_amount": 100000,
                "fee_amount": 10000,
                "withhold_rate": 0.15,
                "campaign_type": "repeat_user",
                "previous_financing_fee_discount_rate": 0.5
            },
            "product_type": "refill"
        }
    }
}

Durch den neuen Kredit wird der aktive Kundenkredit zurückgezahlt und geschlossen. Die Kundin/der Kunde erhält die Differenz. Bei der Auszahlung dieses neuen Kredits wird der Webhook capital.financing_offer.paid_out gesendet. Das Feld previous_financing_fee_discount_amount wird festgelegt.

Rufen Sie die Finanzierungsübersicht ab, um die Details der paid_out-Finanzierung der Kundin/des Kunden anzuzeigen.

Beispielantwort:

{
      "object": "capital.financing_summary",
      "details": {
        "currency": "usd",
        "advance_amount": 1000000,
        "fee_amount": 100000,
        "withhold_rate": 0.2,
        "remaining_amount": 0,
        "paid_amount": 0,
        "current_repayment_interval": {
          "due_at": 123456789,
          "remaining_amount": 50,
          "paid_amount": 50
        },
        "repayments_begin_at": 123456789,
        "advance_paid_out_at": 123456789
      }
    }

Einzelheiten zum Refill und zur ursprünglichen Finanzierung finden Sie auch auf der Seite „Finanzierungsberichterstattung“.

Gehostete Berichterstattung über den ursprünglichen Kredit

Gehostete Berichterstattung über neu finanzierten Kredit