# Kund/innen So verwenden Sie das Kundenobjekt mit Stripe Billing. Das *Kunden* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments)-objekt ist eine zentrale Ressource innerhalb von Stripe. Sie können damit alle Profil-, Abrechnungs- und Steuerinformationen speichern, die für Rechnungen an eine Kundin/einen Kunden für *Abonnements* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) und *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) erforderlich sind. > #### Verwenden Sie die Accounts v2 API zum Darstellen von Kundinnen und Kunden > > Sie können stattdessen kundenkonfigurierte `Konto`-Objekte verwenden, um Ihre Kundinnen und Kunden darzustellen. Die Verwendung von `Accounts` bietet Ihnen eine einheitliche Möglichkeit, Ihre Nutzer/innen produktübergreifend in Stripe darzustellen. > > Die Accounts v2 API ist für Connect-Nutzer/innen allgemein verfügbar und für andere Stripe-Nutzer/innen in der öffentlichen Vorschau. Erfahren Sie mehr über [die Modellierung Ihrer Kundinnen und Kunden als kundenkonfigurierte Konto-Objekte](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) anstelle der Verwendung von `Customer`-Objekten. ## Kund/innen verwalten Legen Sie für alle neuen Nutzer/innen oder Unternehmen, denen Sie Rechnungen ausstellen möchten, eine neue Kundin/einen neuen Kunden an. Richten Sie dabei ein [Mindest-Kundenprofil](https://docs.stripe.com/billing/customer.md#minimum-customer-profile) ein, um die Erstellung von Rechnungen zu vereinfachen, und aktivieren Sie Smart Retries (intelligentes Mahnwesen). Anschließend können Sie mit diesen Kundinnen/Kunden Abonnements erstellen und einmalige Rechnungen ausstellen. #### Dashboard Sie können Kundinnen und Kunden auf der [Seite „Kundinnen und Kunden“](https://dashboard.stripe.com/customers) erstellen und verwalten, wenn Sie keinen Code zum Erstellen einer Kundin oder eines Kunden verwenden möchten oder wenn Sie einer Kundin oder einem Kunden manuell eine einmalige Rechnung ausstellen möchten. Sie können eine Kundin oder einen Kunden auch während der Rechnungserstellung im Dashboard erstellen. ### Kund/in erstellen Wenn Sie neue Kund/innen erstellen, können Sie ihre Konto- und Rechnungsdaten wie **E-Mail**, **Name** und **Land** festlegen. Sie können auch die bevorzugte Sprache des/der Kund/in, die Währung und andere wichtige Details festlegen. Um eine/n Kund/in zu erstellen, führen Sie die folgenden Schritte aus: 1. Stellen Sie sicher, dass der Kunde/die Kundin nicht bereits existiert. 2. Klicken Sie auf der Seite **Kund/innen** auf **Kund/in hinzufügen**, oder drücken Sie **N**. 3. Geben Sie mindestens den **Namen** und die **Konto-E-Mail** Ihres/Ihrer Kund/in ein. 4. Klicken Sie im Dialogfeld auf **Kund/in hinzufügen**. ### Kund/in bearbeiten Um das Profil eines/einer Kund/in zu bearbeiten, führen Sie folgende Schritte aus: 1. Ermitteln Sie den/die Kund/in, den/die Sie ändern möchten, und klicken Sie auf der Seite **Kund/innen** auf den Namen. 2. Wählen Sie auf der Seite mit den Kontoinformationen **Aktionen** > **Angaben bearbeiten** aus. 3. Nehmen Sie Ihre Änderungen am Kundenprofil vor. 4. Klicken Sie auf **Kund/in aktualisieren**. ### Kund/in löschen Um einen/eine Kund/in zu löschen, führen Sie folgende Schritte aus: 1. Ermitteln Sie auf der Seite **Kund/innen** den/die Kund/in, den/die Sie löschen möchten. 2. Aktivieren Sie das Kontrollkästchen neben dem Namen Ihres/Ihrer Kund/in, gefolgt von **Löschen**. Sie können auch auf die Informationsseite des/der Kund/in klicken und **Aktionen** > **Kund/in löschen** auswählen. #### API Bevor Sie einem Kunden/einer Kundin eine Rechnung ausstellen, müssen Sie ein Customer-Objekt erstellen, das Sie mit einem Namen, einer E-Mail-Adresse und einer Zahlungsmethode konfigurieren können. Weitere Informationen hierzu erhalten Sie im [Integrationsleitfaden](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md), und hier ist ein einfaches Beispiel: ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=jenny.rosen@example.com" \ -d payment_method=pm_card_visa \ -d "invoice_settings[default_payment_method]=pm_card_visa" ``` Eine vollständige Liste der Parameter finden Sie unter [Erstellen eines Kunden/einer Kundin](https://docs.stripe.com/api/customers/create.md) mit der API. ## Verfügbare Eigenschaften und Anwendungsmöglichkeiten Die Kundenressource umfasst viele nützliche Eigenschaften, die Sie zum Anpassen der Abrechnung festlegen können. In diesem Abschnitt werden die Eigenschaften erläutert, die Sie in der Kundenressource speichern können, und welche Auswirkungen sie jeweils haben. ### Kundenprofil Ein einfaches Kundenprofil eignet sich zum Generieren von Rechnungen und Zahlungsbelegen und kann grundsätzlich auch als einfaches Customer Relationship Management System (CRM) für Ihre Anwendung dienen. Sie können auch [Stripe-Apps für verbundene Unternehmen und empfohlene Stripe-Apps](https://marketplace.stripe.com/categories/affiliate_and_referrals) verwenden, um Empfehlungs- und Partnerprogramme mit Stripe einzurichten und zu verwalten, Kundeninformationen zu erhalten und Provisionsanpassungen über das Stripe-Dashboard vorzunehmen. #### Einfaches Kundenprofil Legen Sie beim Erstellen einer Kundin/eines Kunden die folgenden Eigenschaften fest: - E-Mail-Adresse - Name der Kundin/des Kunden - Metadaten mit Verweis auf die interne Kunden-ID Ihrer Anwendung Durch die Angabe einer [E-Mail-Adresse](https://docs.stripe.com/api/customers/object.md#customer_object-email) kann Stripe Ihre Kundinnen/Kunden über fehlgeschlagene Zahlungen oder zusätzliche Schritte benachrichtigen, die für den Zahlungsabschluss im Rahmen der [automatischen Abrechnung](https://docs.stripe.com/invoicing/automatic-collection.md) erforderlich sind. Speichern Sie die interne Kunden-ID Ihrer Anwendung im [Metadaten](https://docs.stripe.com/api/customers/object.md#customer_object-metadata)-Attribut. Wie bei den meisten Stripe-Ressourcen enthält auch die Customer-Ressource einen Hash des [Metadaten](https://docs.stripe.com/api/metadata.md)-Objekts, um kontextbezogene Schlüsselwertinformationen flexibel speichern zu können. Speichern Sie Ihre interne Kunden-ID als Schlüssel-Wert-Paar in der Customer-Ressource, um Rechnungsprüfung und Support zu unterstützen. So können Sie anhand Ihrer internen Referenz-ID nach Kundinnen/Kunden suchen. Wir empfehlen jedoch, dass Sie die Kunden-IDs von Stripe auch im internen Kundenmodell Ihrer Anwendung speichern. #### Rechnungs- und Versandadressen Verwenden Sie die Adresseigenschaften, um eine [Adresse](https://docs.stripe.com/api/customers/object.md#customer_object-address) für die Abrechnung (Rechnungsstellung, Stornorechnungen usw.) und eine [Versandadresse](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) (für physische Waren) festzulegen. Während die Versandadresse besonders für Unternehmen wichtig ist, die physische Waren versenden, wird die Rechnungsadresse auf Rechnungen, Stornorechnungen und Zahlungsbelegen angezeigt, was im Hinblick auf steuerliche Vorgaben erforderlich ist. #### Lokalisierung von E-Mails und PDF-Dateien Lokalisieren Sie von Stripe generierte E-Mails und PDF-Dateien, indem Sie die Eigenschaft `preferred_locales` festlegen. Diese Eigenschaft akzeptiert eine nach Präferenz sortierte Liste Ihrer bevorzugten Sprachen. Die bevorzugten Werte für Gebietsschemas basieren auf [RFC-4646](https://tools.ietf.org/html/rfc4646). Dazu gehören beispielsweise „en“ für Englisch oder „fr-CA“ für kanadisches Französisch. Weitere Informationen finden Sie auf der Seite [Rechnungen anpassen](https://docs.stripe.com/invoicing/customize.md#customer-language). #### Rechnungseinstellungen pro Kundin/Kunde Weitere Informationen zum Anpassen von Rechnungsinhalten für jede Kundin/jeden Kunden finden Sie auf der Seite [Rechnungen anpassen](https://docs.stripe.com/invoicing/customize.md). Dort werden [nutzerdefinierte Felder](https://docs.stripe.com/invoicing/customize.md#custom-fields), der Inhalt der [Fußzeile einer Rechnung](https://docs.stripe.com/invoicing/customize.md#footer-field) und das [Anpassen der Rechnungsnummer](https://docs.stripe.com/invoicing/customize.md#invoice-numbering-schemes) erläutert. ### Zahlung Alle Zahlungen werden aus den [Zahlungsangaben](https://docs.stripe.com/payments.md) eines Kunden/einer Kundin erfasst. Kundinnen und Kunden stehen ggf. mehrere Zahlungsmöglichkeiten zur Verfügung, darunter: - [Zahlungsmethoden](https://docs.stripe.com/payments/payment-methods.md) - [Kundenguthaben](https://docs.stripe.com/billing/customer.md#customer-balance) Für Kundinnen/Kunden gilt die Einstellung [einzelne Währung](https://docs.stripe.com/billing/customer.md#currency), d.h. nachdem Sie eine Währung zugewiesen, der Kundin / dem Kunden eine Rechnung gestellt oder [ein Kundenguthaben](https://docs.stripe.com/billing/customer.md#customer-balance) eingerichtet haben, können Sie die Währung nicht mehr ändern. Dieser gesperrte Status ist im Dashboard in einem deaktivierten Dropdown-Menü der **Währung** sichtbar. Wenn Sie einer einzelnen Abrechnungseinheit eine Rechnung mit mehreren Währungen ausstellen müssen, legen Sie für jede Währung eine neue Kundin/einen neuen Kunden an. ### Rechnungsstellung Alle mit der Rechnungsstellung zusammenhängenden Ressourcen sind mit den Kundinnen/Kunden verknüpft, die die Rechnung erhalten. Zu diesen Ressourcen gehören: - [Ausstehende Rechnungsposten](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) - [Abonnements](https://docs.stripe.com/billing/subscriptions/overview.md) - [Rechnungen](https://docs.stripe.com/invoicing/overview.md) - [Belege](https://docs.stripe.com/receipts.md) - [Rechnungseinstellungen](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings) ### Steuerinformationen Um die geltenden steuerlichen Anforderungen zu erfüllen, müssen Sie auf den Rechnungen gegebenenfalls die Steuernummer der Kundin/des Kunden sowie weitere Informationen angeben. Stellen Sie sicher, dass die Rechnungen Ihrer Kundinnen und Kunden die entsprechenden Informationen enthalten. Zu den Informationen gehören unter anderem [Steuer-IDs](https://docs.stripe.com/billing/customer/tax-ids.md), [Steuerbefreiungen](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt) und [Adressen](https://docs.stripe.com/billing/customer.md#addresses). Steueridentifikationsnummern bieten eine Möglichkeit, eine oder mehrere Steueridentifikationsnummern auf Rechnungen zu speichern und darzustellen. Der Steuerbefreiungsstatus gibt an, ob das Unternehmen steuerpflichtig ist. Standardmäßig ist der `tax_exempt`-Status eines Kunden/einer Kundin auf `none` festgelegt, d. h. es handelt sich um eine steuerpflichtige Abrechnungseinheit. Sie können jedoch einen Kunden/eine Kundin als für die Zahlung der Steuer auf einer Rechnung verantwortlich kennzeichnen, indem Sie die `tax_exempt`-Eigenschaft auf `reverse` machen, oder ihn/sie als steuerbefreit kennzeichnen, indem Sie den Status auf „`exempt` festlegen. Weitere Informationen zur Verwendung von `tax_exempt` und `reverse` machen finden Sie auf der Seite [Tax Rates](https://docs.stripe.com/tax/tax-rates.md#tax-exempt-and-reverse-charge). ## Häufige Aufgaben In diesem Abschnitt werden einige der häufigsten Aufgaben erläutert, die Sie mit der Kundenressource durchführen können. ### Abonnement erstellen Bevor Sie ein neues Abonnement erstellen können, müssen Sie zu Abrechnungszwecken eine neue Kundin/einen neuen Kunden erstellen. 1. [Erstellen Sie den Kunden](https://docs.stripe.com/billing/customer.md#create-a-customer). 2. Definieren Sie Ihren [Produktkatalog](https://docs.stripe.com/products-prices/manage-prices.md#create-product) und die [Preise](https://docs.stripe.com/products-prices/manage-prices.md#create-price). 3. [Erstellen Sie ein Abonnement](https://docs.stripe.com/billing/subscriptions/overview.md) mit der/dem in Schritt eins erstellten Kundin/Kunden und einem Preis (oder mehreren Preisen) aus Schritt zwei. Sie können die Kundendaten auch nach der Erstellung des Abos weiterhin aktualisieren, bis eine Rechnung [abgeschlossen ist](https://docs.stripe.com/invoicing.md). Alle Änderungen gelten für den nächsten Rechnungsstellungszeitraum, wenn eine neue Rechnung auf Grundlage des aktuellen Kundenstatus beim Erstellen von PDFs, E-Mails und der gehosteten Rechnungsseite generiert wird. Weitere Informationen finden Sie auf der Seite [So funktionieren Abos](https://docs.stripe.com/billing/subscriptions/overview.md). ### Einmalige (manuelle) Rechnung an eine Kundin/einen Kunden senden Im Gegensatz zu Abonnementrechnungen werden einmalige Rechnungen manuell erstellt. Es gibt keinen automatisierten Zeitplan für diese Rechnungen. So eignen sie sich besonders für die Abrechnung von einmaligen Aufträgen und Arbeiten, wie beispielsweise Einrichtungs- und Installationsgebühren, Beratungsgebühren oder einzelne Bestellungen für physische Waren usw. 1. [Erstellen Sie den Kunden](https://docs.stripe.com/billing/customer.md#create-a-customer). 2. [Erstellen Sie einen neuen Rechnungsentwurf](https://docs.stripe.com/invoicing/dashboard.md#create-invoice), indem Sie Rechnungsposten mit einer Beschreibung, einer Menge, einem Stückpreis und einem Steuersatz hinzufügen. 3. [Legen Sie die Zahlungsmethode für die Rechnung fest](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). Sie können die Zahlung für eine Rechnung einziehen, indem Sie entweder automatisch die hinterlegte Zahlungsmethode belasten oder die Rechnung per E-Mail an die Kundin/den Kunden senden. 4. Stellen Sie die Rechnung fertig. Ausführliche Informationen zum Erstellen und Einziehen von Zahlungen für einmalige Rechnungen finden Sie in der [Dokumentation zu einmaligen Rechnungen](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). ### Kundenguthaben speichern Mit der Funktion [Kundenguthaben](https://docs.stripe.com/billing/customer/balance.md) können bestimmten Kundinnen/Kunden Korrekturen im Habensaldo und Sollsaldo zugeordnet werden. Das so ermittelte Guthaben wird bei künftigen Rechnungen für diese Kundin/diesen Kunden angerechnet. ### Steueridentifikationsnummern hinzufügen und validieren Die Angabe der Steuer-ID einer Kundin/eines Kunden auf Rechnungsdokumenten ist eine übliche steuerliche Anforderung. Mit Stripe können Sie einer Kundin/einem Kunden eine oder mehrere [Steuer-IDs](https://docs.stripe.com/billing/customer/tax-ids.md) hinzufügen. Die Steuer-IDs der Kundin/des Kunden werden in der Kopfzeile von PDF-Rechnungen und -Stornorechnungen angezeigt. Mehr Informationen dazu finden Sie auf der Seite [Steuer-IDs](https://docs.stripe.com/billing/customer/tax-ids.md). ### Währung für eine/n Kund/in festlegen Die Eigenschaft `Währung` ist ein aus drei Buchstaben bestehender [ISO-Code für die Währung](https://docs.stripe.com/currencies.md), in der Sie das Kundenkonto für wiederkehrende Zahlungen belasten. Sie können die Währung im Dashboard festlegen, indem Sie zur Seite **Kunden/Kundinnen** > **Details** navigieren und auf **Details aktualisieren** klicken. Nachdem Sie die Währung festgelegt haben, können Sie sie nicht mehr ändern. Durch Erstellen einer Rechnung, eines Rechnungspostens oder eines Guthabens für den Kunden/die Kundin wird die Kundenwährung ebenfalls dauerhaft festgelegt.