RefillsPrivate Vorschau

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 und ein Rabatt auf die verbleibende Kreditprämie gewährt.

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

Lebenszyklus von Refill-Angeboten

1. Stripe prüft täglich den Anspruch von aktiven Capital-Nutzer/innen auf Refill-Finanzierung, genau wie bei Standardfinanzierungsangeboten.

2. 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.

3. 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.

4. 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

5. Kundinnen und Kunden, die das Refill-Angebot annehmen, wird ein Rabatt in Form eines Prozentsatzes auf die verbleibende Prämie ihres bestehenden Kredits angeboten. Dieser Rabattsatz wird unter offered_terms als previous_financing_fee_discount_rate ausgewiesen.

6. Wenn die Kundin/der Kunde das Refill-Angebot annimmt, senden wir den Webhook capital.financing_offer.accepted. Die Webhook-Nutzlast enthält das Feld accepted_terms mit den von der Kundin/dem Kunden 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.

   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"
           }
       }
   }

7. 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.

8. 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
         }
       }

9. 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