# Steuern automatisch über die Checkout-Seite erheben Erfahren Sie, wie Sie Steuern mithilfe der von Stripe gehosteten Checkout-Seite oder des eingebetteten Formulars automatisch berechnen können. Stripe Tax berechnet automatisch die Steuern auf alle Käufe und *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), die während einer Checkout-Sitzung zusammengekommen sind. Wenn Sie Checkout noch nicht integriert haben, schließen Sie die Integration anhand des [Leitfadens zum Akzeptieren von Zahlungen](https://docs.stripe.com/checkout/quickstart.md) ab. [Watch on YouTube](https://www.youtube.com/watch?v=fMk7y-C6JuM) ## Checkout-Sitzung erstellen Sie können Checkout-Sitzungen für einmalige und wiederkehrende Käufe erstellen. Die Steuersätze eines Kunden/einer Kundin stammen von seinem/ihrem Standort, der von Checkout anhand der Kundenadresse ermittelt wird. Die Adresse, die Checkout zur Berechnung der Steuern verwendet, hängt davon ab, ob es sich bei dem Kunden/der Kundin um eine/n neue/n oder eine/n bestehende/n Kunden/Kundin handelt und ob Sie während der Checkout-Sitzung Versandadressen erfassen: | | Neue/r Kunde/Kundin | Bestehende/r Kunde/Kundin | | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nur eine Abrechnungsadresse erfassen** | Checkout berechnet Steuern basierend auf der Abrechnungsadresse des/der Kund/in, die in der Checkout-Sitzung eingegeben wurde | Wenn die Kundin/der Kunde bereits eine Versandadresse gespeichert hat, berechnet Checkout die Steuern basierend auf dieser Adresse. Andernfalls können Sie die Steuern anhand der während des Bezahlvorgangs eingegebenen Rechnungsadresse (durch Angabe von [customer_update[address]=auto](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-address)) berechnen oder der Rechnungsadresse, die für die Kundin/den Kunden gespeichert ist. Letztere Option ist das Standardverfahren. | | **Eine Versandadresse erfassen** | Checkout berechnet Steuern basierend auf der Versandadresse des/der Kund/in, die in der Checkout-Sitzung eingegeben wurde | Checkout berechnet Steuern basierend auf der Versandadresse des/der Kund/in, die in der Checkout-Sitzung eingegeben wurde. *Bestehende Adressen für diese/n Kund/in gelten in diesem Fall nicht.* | > Um sicherzustellen, dass Google Pay als Zahlungsmethode angeboten wird, während Sie Stripe Tax in Checkout verwenden, müssen Sie entweder die Erfassung einer Lieferadresse anfordern oder einem bestehenden Kunden eine gespeicherte Lieferadresse mitteilen. Apple Pay mit Stripe Tax wird nur angezeigt, wenn der Browser des Kunden Apple Pay Version 12 oder höher unterstützt. ## Steuern für neue Kundinnen/Kunden berechnen Legen Sie `customer_creation=always` in der Checkout-Session fest, um einen kundenkonfigurierten [Account](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) oder einen kundenkonfigurierten [Customer](https://docs.stripe.com/api/customers.md) mit den erfassten Abrechnungs- und Versandadressen zu erstellen, wenn kein bestehender Kunde/keine bestehende Kundin identifiziert wird. Checkout berechnet die Steuer anhand des Standorts der Versandadresse, falls angegeben, oder auch der Rechnungsadresse. #### Von Stripe gehostete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d customer_creation=always \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` #### Vollständig eingebettete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d customer_creation=always \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` ## Steuern für bestehende Kundinnen/Kunden berechnen #### Accounts v2 Um Steuern für Checkout-Sessions zu berechnen, die für bestehende kundenkonfigurierte [Accounts](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) erstellt wurden, setzen Sie `automatic_tax.enabled` auf true und geben Sie die `customer_account`-ID an. Checkout verwendet die folgende Adresspriorisierung zur Steuerberechnung: 1. Falls angegeben, verwendet Checkout die [erfasste Versandadresse](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection) zur Steuerberechnung. Wenn Sie die Versandadresse erfassen, müssen Sie außerdem `customer_update.shipping` auf `auto` setzen, um `Account` mit der erfassten Versandadresse hinzuzufügen oder zu aktualisieren. #### Von Stripe gehostete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "customer_update[shipping]=auto" \ -d "shipping_address_collection[allowed_countries][0]=US" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` #### Vollständig eingebettete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "customer_update[shipping]=auto" \ -d "shipping_address_collection[allowed_countries][0]=US" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` 1. Wenn Sie die Versandadresse nicht erfassen, verwendet Checkout die [vorhandene Versandadresse](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer-shipping-address) von `Account` zur Steuerberechnung, sofern verfügbar. 1. Wenn keine Versandadresse verfügbar ist, verwendet Checkout die Abrechnungsadresse zur Steuerberechnung. Setzen Sie `billing_address_collection` auf `required`, um immer eine Abrechnungsadresse einzuziehen, oder belassen Sie es bei `auto` (Standard), um sie bei Bedarf einzuziehen. Wenn Checkout die Abrechnungsadresse erfasst, setzen Sie `customer_update.address` auf `auto`, um Tax anzuweisen, die erfasste Abrechnungsadresse zu verwenden, oder auf `never`, um die vorhandene Adresse des `Account` zur Steuerberechnung zu verwenden. #### Von Stripe gehostete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "customer_update[address]=auto" \ -d billing_address_collection=required \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` #### Vollständig eingebettete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "customer_update[address]=auto" \ -d billing_address_collection=required \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` 1. Andernfalls verwendet Checkout Adressen aus dem `Account` gemäß der [Adresshierarchie](https://docs.stripe.com/tax/customer-locations.md#address-hierarchy). #### Customer v1 Um Steuern für Checkout-Sessions zu berechnen, die für bestehende Kundinnen und Kunden erstellt wurden, setzen Sie `automatic_tax[enabled]` auf `true` und geben Sie die `Kunden`-ID an. Checkout verwendet die folgende Adresspriorisierung, um Steuern zu berechnen: 1. Falls angegeben, verwendet Checkout die [erfasste Versandadresse](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection) zur Berechnung der Steuern. Wenn Sie die Versandadresse erfassen, müssen Sie auch den Wert `customer_update[shipping]` auf `automatisch` setzen, um die Kundin oder den Kunden mit der erfassten Versandadresse hinzuzufügen oder zu aktualisieren. #### Von Stripe gehostete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d "customer_update[shipping]=auto" \ -d "shipping_address_collection[allowed_countries][0]=US" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` #### Vollständige eingebettete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d "customer_update[shipping]=auto" \ -d "shipping_address_collection[allowed_countries][0]=US" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` 1. Wenn Sie die Versandadresse nicht erfassen, verwendet Checkout die [vorhandene Versandadresse](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) der Kundin/des Kunden zur Berechnung der Steuern, sofern verfügbar. 1. Wenn die Versandadresse nicht verfügbar ist, verwendet Checkout die Rechnungsadresse zur Berechnung der Steuern. Legen Sie `billing_address_collection` auf `erforderlich` fest, um immer eine Rechnungsadresse zu erfassen, oder belassen Sie es bei `automatischer` (Standard-)Erfassung, um die Rechnungsadresse bei Bedarf einzuziehen. Wenn Checkout die Rechnungsadresse erfasst, setzen Sie `customer_update[address]` auf `automatisch`, um Tax anzuweisen, die erfasste Rechnungsadresse zu verwenden, oder auf `niemals`, um niemals die vorhandene Adresse der Kundin oder des Kunden zur Berechnung der Steuern zu verwenden. #### Von Stripe gehostete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d "customer_update[address]=auto" \ -d billing_address_collection=required \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` #### Vollständige eingebettete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d "customer_update[address]=auto" \ -d billing_address_collection=required \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` 1. Andernfalls verwendet Checkout Adressen der Kundin/des Kunden, wobei eine [Adresshierarchie](https://docs.stripe.com/tax/customer-locations.md#address-hierarchy) angewandt wird. ## Antwort überprüfen Um die Ergebnisse der neuesten Steuerberechnung zu überprüfen, können Sie den von Checkout berechneten Steuerbetrag in der Eigenschaft [total_details.amount_tax](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) in der Checkout-Sitzungsressource lesen. Darüber hinaus können Sie im Dashboard das Steuerergebnis [einer jeden Zahlung anzeigen](https://dashboard.stripe.com/test/payments). ## Optional: Produkte und Preise aktualisieren Stripe Tax verwendet die zu Ihren Produkten und Preisen gespeicherten Informationen zur Steuerberechnung, einschließlich Steuercodes und Steuerverhalten. Wenn Sie diese nicht explizit konfigurieren, verwendet Stripe Tax die Standardeinstellungen aus Ihren [Steuereinstellungen](https://dashboard.stripe.com/settings/tax). Detaillierte Einrichtungsanweisungen finden Sie unter [Produktsteuercodes und Steuerverhalten festlegen](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md). ## Optional: Angabe von Steuercodes beim Inline-Erstellen von Produkten Wenn Sie einen Bezahlvorgang mit [line_items.price_data.product_data](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price_data-product_data) erstellen, können Sie einen Steuercode direkt in der Anfrage angeben. Wir empfehlen Ihnen, dies zu tun, wenn Sie neue Produkte erstellen, anstatt bestehende Produkt-IDs zu verwenden. #### Von Stripe gehostete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][currency]=usd" \ -d "line_items[0][price_data][unit_amount]=2000" \ -d "line_items[0][price_data][product_data][name]=T-shirt" \ -d "line_items[0][price_data][product_data][tax_code]=txcd_99999999" \ -d "line_items[0][quantity]=1" \ -d "automatic_tax[enabled]=true" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` #### Vollständig eingebettete Seite ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][currency]=usd" \ -d "line_items[0][price_data][unit_amount]=2000" \ -d "line_items[0][price_data][product_data][name]=T-shirt" \ -d "line_items[0][price_data][product_data][tax_code]=txcd_99999999" \ -d "line_items[0][quantity]=1" \ -d "automatic_tax[enabled]=true" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` Ersetzen Sie `txcd_99999999` durch den entsprechenden [Steuercode](https://docs.stripe.com/tax/tax-codes.md) für Ihr Produkt. Der Steuercode bestimmt, wie das Produkt steuerlich kategorisiert wird. Wenn Sie keinen Steuercode angeben, verwendet Stripe Tax den Standard-Steuercode aus Ihren [Steuereinstellungen](https://dashboard.stripe.com/settings/tax). ## See also - [Ihre Steuer-Integration testen](https://docs.stripe.com/tax/testing.md) - [Endkundenstandorte ermitteln](https://docs.stripe.com/tax/customer-locations.md) - [Berichterstattung und Einreichung](https://docs.stripe.com/tax/reports.md)