# Refills

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

> Capital für Plattformen ist in der [öffentlichen Vorschau](https://docs.stripe.com/release-phases.md) verfügbar.

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.

## Before you begin

- Diese Anleitung setzt voraus, dass Sie eine [API-Integration](https://docs.stripe.com/capital/api-integration.md) abgeschlossen haben.
- Refills sind nicht standardmäßig aktiviert. Nachdem Sie Ihre Integration aktualisiert haben, um Refills zu unterstützen, müssen Sie Details zu Ihrer Integration und API-Nutzung über das [Änderungsanfrageformular](https://form.asana.com/?k=8K51UWmWhttehNFD5qBLdg&d=974470123217835) zur Compliance-Prüfung an Stripe übermitteln.

## Lebenszyklus von Refill-Angeboten

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

1. Wenn ein Refill-Angebot erstellt wird, erhalten Sie den *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `capital.financing_offer.created`, der `"product_type": "refill"` enthält, um anzugeben, dass es sich um ein Refill-Angebot handelt.

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

1. Das verbundene Konto greift auf die Aufstockungsanwendung mit demselben Konto-Link zu, der im [Leitfaden zur API-Einrichtung](https://docs.stripe.com/capital/api-integration.md#send-offer-email) angegeben ist. Das verbundene Konto kann einen benutzerdefinierten Schieberegler bis zum maximalen qualifizierten Angebotsbetrag anpassen.

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

1. Wenn der Kunde/die Kundin das Refill-Angebot annimmt, senden wir den *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `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:

   ```json
   {
       "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"
           }
       }
   }
   ```

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

1. [Rufen Sie die Finanzierungsübersicht ab](https://docs.stripe.com/api/capital/financing_summary.md), um die Details der `paid_out`-Finanzierung der Kundin/des Kunden anzuzeigen.

   Beispielantwort:

   ```json
       {
         "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
         }
       }
   ```

1. Einzelheiten zur Aufstockung und zur ursprünglichen Finanzierung finden Sie auch auf der Seite [Finanzierungsberichterstattung](https://dashboard.stripe.com/test/connect/capital/financing_offers).

## Verhalten von Refills im Vereinigtes Königreich Refill

Refills im Vereinigten Königreich verhalten sich anders als Refills in den USA. Die folgenden Unterschiede gelten, wenn ein verbundenes Konto im Vereinigten Königreich ansässig ist.

### Zwei gleichzeitig aktive Finanzierungen

Wenn ein Refill im Vereinigten Königreich angenommen und ausgezahlt wird, bleibt die ursprüngliche Finanzierung aktiv. Im Gegensatz zu Refills in den USA wird bei der Auszahlung des Refill nicht automatisch die ursprüngliche Finanzierung zurückgezahlt.

### Bestellung und Steuersatz einbehalten

Wenn Sie das Refill Angebot annehmen, wenden wir den neuen Einbehaltungssatz auf Ihre ursprüngliche Finanzierung an. Sobald dieser vollständig zurückgezahlt ist, beginnen wir mit dem Einbehalt für die neue Finanzierung.

### Webhook-Ereignisreihenfolge

Bei Konten im Vereinigten Königreich wird `capital.financing_offer.fully_repaid` zum Zeitpunkt der Auszahlung von Refills nicht für die ursprüngliche Finanzierung ausgegeben. Dieses Ereignis wird später übermittelt, wenn die ursprüngliche Finanzierung tatsächlich vollständig zurückgezahlt ist.

Zwischen den USA und dem Vereinigten Königreich gibt es keinen Unterschied im Webhook-Verhalten `capital.financing_offer.created`. Das Refill Angebot wird in beiden Fällen mit `product_type=Refill` erstellt und Angebote können wie gewohnt über die FinancingOffer API aufgelistet und abgerufen werden.

## See also

- [Einrichten einer API-Integration](https://docs.stripe.com/capital/api-integration.md)
