RefillsÖffentliche Vorschau

Aufstockungen sind zusätzliche Finanzierungsangebote, die an verbundene Konten gesendet werden, die bei der Rückzahlung ihres laufenden Finanzierungsbetrags erhebliche Fortschritte gemacht haben. Wenn sie genehmigt werden, zahlen Aufstockungsangebote den verbleibenden Saldo des laufenden Kontos zurück.

Bevor Sie loslegen

• Diese Anleitung setzt voraus, dass Sie eine API-Integration abgeschlossen haben.
• Aufstockungen sind standardmäßig nicht aktiviert. Nachdem Sie Ihre Integration so aktualisiert haben, dass sie Aufstockungen unterstützt, müssen Sie uns kontaktieren, um Aufstockungsangebote zu aktivieren.

Lebenszyklus von Refill-Angeboten

1. Stripe prüft täglich aktive, mit Capital verbundene Konten auf ihre Eignung für Aufstockungsfinanzierungen.

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. Das verbundene Konto greift auf die Aufstockungsanwendung mit demselben Konto-Link zu, der im Leitfaden zur API-Einrichtung angegeben ist. Das verbundene Konto kann einen benutzerdefinierten Schieberegler bis zum maximalen qualifizierten Angebotsbetrag anpassen.

   

   Refill-Antrag

   

   Refill-Antrag

5. Verbundenen Konten, die das Aufstockungsangebot annehmen, wird möglicherweise ein Rabatt angeboten (als Prozentsatz auf den verbleibenden Aufpreis ihres bestehenden Guthabens). Dieser Rabattsatz wird als previous_financing_fee_discount_rate unter offered_terms angezeigt.

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

7. Mit der neuen Finanzierung wird zunächst der aktive Saldo des Kunden zurückgezahlt und abgeschlossen. Die/Der Kunde/Kundin erhält die Differenz. Diese neue Auszahlung der Finanzierung sendet den Webhook capital.financing_offer.paid_out. Zu diesem Zeitpunkt wird das Feld previous_financing_fee_discount_amount 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 zur Aufstockung und zur ursprünglichen Finanzierung finden Sie auch auf der Seite Finanzierungsberichterstattung.

   

   Gehostete Berichterstattung über das ursprüngliche Finanzierungsangebot

   

   Gehostete Berichterstattung über neu aufgestockte Finanzierungsangebote