# Saldo der Kundenrechnung Erfahren Sie, wie Sie den Saldo der Kundenrechnung verwenden. Alle Kundinnen/Kunden in Stripe Billing verfügen über einen Rechnungssaldo, für den Sie Gutschrift- und Lastschriftanpassungen vornehmen können. Bei den Anpassungen des Rechnungssaldos kann es sich um Gutschriften (d. h. Sie schulden Kundinnen/Kunden Geld) oder Lastschriften (d. h. Kundinnen/Kunden schulden Ihnen Geld) handeln. Aus diesen Anpassungen ergibt sich ein Kundensaldo, den Sie auf künftige *Rechnungen* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) anwenden können. Da der Rechnungssaldo aus einem Geschäftsbuch (einer unveränderlichen Liste von Lastschrift- und Gutschrifttransaktionen) berechnet wird, bietet es einen Transaktionsprüfpfad für Kundinnen/Kunden. Diese [Kundensaldo-Transaktionen](https://docs.stripe.com/api/customer_balance_transactions/object.md) können sich auf das zu der Anpassung gehörende Objekt (zum Beispiel eine [Stornorechnung](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) oder [ein Kunde/eine Kundin](https://docs.stripe.com/invoicing/customer.md)) oder sogar auf [Metadaten](https://docs.stripe.com/api/metadata.md) für Ihren eigenen Bedarf beziehen. ## Beispiel-Anwendungsszenarien Nachfolgend sind einige häufige Anwendungsszenarien für Kundenrechnungssalden aufgelistet: - [Ausstellen einer Gutschrift](https://docs.stripe.com/invoicing/dashboard/credit-notes.md), um ein Guthaben zu erstellen, das den mit der nächsten Rechnung fälligen Betrag reduziert. - Durch die [Herabstufung eines Abonnements](https://docs.stripe.com/billing/subscriptions/change-price.md) entstehende anteilsmäßige Verrechnungen können indirekt Gutschriften erstellt werden, um den mit der nächsten Rechnung fälligen Betrag zu reduzieren. - Wenn der für eine Rechnung fällige Betrag unter dem [Mindestbetrag für Zahlungen](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) liegt, wird die Rechnung als bezahlt gekennzeichnet und der geschuldete Betrag als Lastschrift in den Rechnungssaldo übertragen. Diese Funktion steht nur für Kundinnen/Kunden ohne [cash_balance](https://docs.stripe.com/billing/customer/balance.md#cash-balances) zur Verfügung. ## Details zum Saldo einer Kundenrechnung Berücksichtigen Sie bei der Verwendung von Kundenrechnungssalden folgende Details: - Der Rechnungssaldo wird automatisch auf die nächste für die Kundin/den Kunden finalisierte Rechnung angewendet. - Die Auswahl einer bestimmten Rechnung, auf die der Rechnungssaldo angewendet werden soll, ist nicht möglich. - Die Anwendung des Rechnungssaldos auf eine Rechnung kann nicht verhindert werden. - Der Rechnungssaldo wird in der Währung des Kunden/der Kundin angegeben. - Kund/innen mit [Barguthaben](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) können ein positives Guthaben nicht beibehalten. Sie können den mit der nächsten Rechnung fälligen Betrag also nicht erhöhen. - Der Rechnungssaldo gilt nicht für Rechnungen, die durch Checkout-Sitzungen erstellt wurden, bei denen [`invoice_creation`](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-invoice_creation) aktiviert ist. - Sie können keine Rechnungssalden auf zuvor erstellte Rechnungen anwenden, die noch offen sind. Durch das [Bearbeiten einer offenen Rechnung](https://docs.stripe.com/invoicing/invoice-edits.md) wird jedoch ein etwaiger Rechnungssaldo auf die Rechnungsprüfung angewendet. ## Lastschriften und Gutschriften **Negative Werte** werden als *Gutschrift* (Reduzierung des geschuldeten Betrags der Kundin/des Kunden) behandelt, die Sie auf die nächste Rechnung anwenden können. **Positive Werte** werden als *Lastschrift* (Erhöhung des geschuldeten Betrags der Kundin/des Kunden) behandelt, die Sie auf die nächste Rechnung anwenden können. ## Transaktionen Sämtliche Änderungen des Rechnungssaldos werden als [Transaktionen](https://docs.stripe.com/api/customer_balance_transactions/object.md) erfasst. Nach der Erstellung können Sie nur noch die `description` oder die `metadata` der Transaktion aktualisieren – andere Eigenschaften können Sie nicht bearbeiten und auch keine Transaktion löschen. ### Transaktionen rückgängig machen Sie können eine Transaktion nur rückgängig machen, indem Sie eine entsprechende Umkehrtransaktion erstellen. Beispiel: Wenn Sie einer Kundin/einem Kunden 10 USD gutschreiben, müssen Sie über eine neue Transaktion das Guthaben der Kundin/des Kunden mit 10 USD belasten. Dabei heben sich beide Transaktionen gegenseitig auf. ### Transaktionstypen Sämtliche über die API oder das Dashboard erstellten [Transaktionen](https://docs.stripe.com/api/customer_balance_transactions/object.md) haben als [Typ](https://docs.stripe.com/api/customer_balance_transactions/object.md#customer_balance_transaction_object-type) den Wert `adjustment`, der eine von Ihnen für die Kundin/den Kunden manuell erstellte Lastschrift oder Gutschrift darstellt. Die Eigenschaft `type` hat viel mehr mögliche Werte, mit denen die Erstellungsquelle und der Grund für die Transaktion dargestellt werden können. In der nachfolgenden Tabelle finden Sie einen Überblick und eine Beschreibung jedes dieser Werte für die Eigenschaft`type`: | Typ | Beschreibung | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `adjustment` | Eine explizit erstellte Korrekturtransaktion zur Belastung oder Gutschrift des Rechnungssaldos. Dies ist der einzige Transaktionstyp, den Sie mit API-Integrationen und über das Dashboard erstellen können. | | `applied_to_invoice` | Verfolgt die Anwendung des Guthabens auf eine verknüpfte [Rechnung](https://docs.stripe.com/invoicing/overview.md) nach. | | `credit_note` | Verfolgt die Erstellung einer Gutschrift für eine [Stornorechnung](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) und die zugehörige [Rechnung](https://docs.stripe.com/invoicing/overview.md). | | `invoice_too_small` | Wenn der fällige Betrag einer Rechnung unter unserem [Mindestabrechnungsbetrag](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) liegt und die Kundin oder der Kunde kein Guthaben hat, belasten wir die Rechnung mit dem Rechnungssaldo und addieren ihn zu dem fälligen Betrag der nächsten ausgestellten Rechnung. | | `invoice_too_large` | Wenn der fällige Betrag einer Rechnung über unserem [Höchstabrechnungsbetrag](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) liegt und die Kundin oder der Kunde kein Guthaben hat, belasten wir die Rechnung mit dem Rechnungssaldo und addieren ihn zu dem fälligen Betrag der nächsten ausgestellten Rechnung. | | `unapplied_from_invoice` | Verfolgt die Rückbuchung eines angewendeten Rechnungssaldos von einer verknüpften [Rechnung](https://docs.stripe.com/invoicing.md). Mit früherer `applied_to_invoice`-Transaktion gekoppelt. | | `unspent_receiver_credit` | Wenn unverbrauchte Gelder in [Empfängerquellen](https://docs.stripe.com/sources.md#flow-for-customer-action) einer Kundin/eines Kunden ohne Barguthaben nach 60 Tagen nicht vollständig abgebucht sind, bucht Stripe sie in Ihrem Auftrag automatisch ab und erstellt eine Gutschrift in Ihrem Guthaben. Außerdem erstellt Stripe eine entsprechende Gutschrifttransaktion. | | `initial` | Stellt den Anfangswert des Saldos der Kundenrechnung dar, wenn die Kundin/der Kunde über die API mit einem Guthaben, das ungleich null ist, erstellt wird. | ## Rechnungssaldo ändern Sie können den Saldo einer Kundenrechnung im Dashboard ändern, indem Sie auf der Seite mit den Kundendetails eine neue Korrektur der [Kundensaldo-Transaktion](https://docs.stripe.com/api/customer_balance_transactions/object.md) erstellen. Klicken Sie unter **Saldo der Kundenrechnung** auf **Saldo anpassen**, um das Modal **Guthabenanpassung** hinzuzufügen. Sie können Informationen zur Korrektur festlegen, z. B.: - **Art der Korrektur**: Gutschrift oder Lastschrift auswählen - **Währung**: Nur verfügbar, wenn der Kunde/die Kundin keine Währung festgelegt hat - **Betrag** - **Interner Hinweis**: Für Dashboard-Nutzer/innen sichtbar, aber nicht für den Kunden/die Kundin ![So passen Sie das Abonnementguthaben eines Kunden/einer Kundin an.](https://b.stripecdn.com/docs-statics-srv/assets/2-Customer-balance.ed7d6df96ba2b8595461e1091e4da7a9.png) ### API Erstellen Sie Anpassungen mit der [Customer Balance API](https://docs.stripe.com/api/customer_balance_transactions/create.md), wie im folgenden Codebeispiel dargestellt. ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" \ -d amount=-500 \ -d currency=usd ``` ## Transaktionsverlauf des Rechnungssaldos Prüfen Sie Korrekturen des Saldos einer Kundenrechnung im Dashboard auf der Seite mit den zugehörigen Kundendetails unter **Saldo der Kundenrechnung**. In diesem Bereich wird der aktuelle Betrag des Rechnungssaldos angezeigt. Klicken Sie auf **Details anzeigen**, um den zur Berechnung dieses Werts verwendeten Transaktionsverlauf anzuzeigen. In jeder Transaktionszeile werden die für den [Transaktionstyp](https://docs.stripe.com/billing/customer/balance.md#types) relevanten Informationen angezeigt, z. B. ein Link zur Rechnung, die auf den Rechnungssaldo angewendet wurde, oder die Stornorechnung, die dem Saldo gutgeschrieben wurde. ![Transaktionsverlauf des Rechnungssaldos anzeigen](https://b.stripecdn.com/docs-statics-srv/assets/3-Balance-history.446845092bb178c7924a9cbee2538f94.png) ### API Verwenden Sie die [Kundensaldoliste](https://docs.stripe.com/api/customer_balance_transactions/list.md), um eine Liste aller Transaktionen für einen Kunden/eine Kundin abzurufen. ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" ``` ## Barguthaben von Kund/innen Kundinnen und Kunden, die die Zahlungsmethode [Banküberweisungen](https://docs.stripe.com/payments/bank-transfers.md) verwenden, haben ein [Barguthaben-Objekt](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) mit einer oder mehreren Währungen im Objekt `available`. Sie können das Guthaben verwenden, um [Zahlungen zu tätigen](https://docs.stripe.com/payments/customer-balance.md#make-cash-payment) oder Rechnungen zu bezahlen. Kundinnen/Kunden mit verfügbarem Guthaben weisen folgendes Verhalten auf: - Sie können kein negatives Barguthaben für Kund/innen erstellen, da diese von Ihrem/Ihrer `Customer` gesendete Gelder repräsentiert. - Sie können zu niedrige oder zu hohe Rechnungen mittels des Barguthabens finalisieren (z. B. ein Abonnement über 0,01 USD erstellen). Hier erfahren Sie mehr über [Mindest- und Höchstbeträge](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts). - Sie können `Customers` löschen, die über ein Barguthaben verfügen, aber nur, wenn ihr Barguthaben 0 ist. - Das verfügbare Guthaben eines/einer `Customer` kann nicht entfernt werden.