Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

Automatisch Steuern für Checkout-Sitzungen einziehen

So berechnen Sie automatisch Steuern in Checkout.

Stripe Tax berechnet automatisch die Steuern auf alle Käufe und Abonnements, die während einer Checkout-Sitzung zusammengekommen sind. Wenn Sie Checkout nicht integriert haben, müssen Sie die Integration mithilfe des Leitfadens zur Annahme von Zahlungen abschließen.

Dieses Video zeigt, wie Sie die automatische Steuererhebung bei der Verwendung von gehosteten Integrationen wie Stripe Checkout aktivieren können.

Videoinhalte werden geladen …

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 Kund/inBestehende/r Kund/in
Nur eine Abrechnungsadresse erfassenCheckout berechnet Steuern basierend auf der Abrechnungsadresse des/der Kund/in, die in der Checkout-Sitzung eingegeben wurdeWenn 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) berechnen oder der Rechnungsadresse, die für die Kundin/den Kunden gespeichert ist. Letztere Option ist das Standardverfahren.
Eine Versandadresse erfassenCheckout berechnet Steuern basierend auf der Versandadresse des/der Kund/in, die in der Checkout-Sitzung eingegeben wurdeCheckout 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.

Hinweis

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 ein Kundin/Kunden mit erfassten Rechnungs- und Versandadressen zu erstellen, wenn kein/e bestehende/r Kundin/Kunde identifiziert wird.

Checkout berechnet die Steuer anhand des Standorts der Versandadresse, falls angegeben, oder auch der Rechnungsadresse.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

Steuern für bestehende Kundinnen/Kunden berechnen

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

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/checkout/sessions \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -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"

  2. Wenn Sie die Versandadresse nicht erfassen, verwendet Checkout die vorhandene Versandadresse der Kundin/des Kunden zur Berechnung der Steuern, sofern verfügbar.

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

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/checkout/sessions \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -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"

  4. Andernfalls verwendet Checkout Adressen der Kundin/des Kunden, wobei eine Adresshierarchie 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 in der Checkout-Sitzungsressource lesen. Darüber hinaus können Sie im Dashboard das Steuerergebnis einer jeden Zahlung anzeigen.

OptionalProdukte und Preise aktualisieren

Stripe Tax verwendet Informationen, die zu Produkten und Preisen gespeichert sind, um Steuern zu berechnen, wie z. B. Steuercode und Steuerverhalten. Wenn Sie diese Konfigurationen nicht explizit angeben, verwendet Stripe Tax den in den Steuereinstellungen ausgewählten Standard-Steuercode.

Weitere Informationen finden Sie unter Produkt-Steuerkennzeichen und Steuerverhalten festlegen.

OptionalAngabe von Steuercodes beim Inline-Erstellen von Produkten

Wenn Sie einen Bezahlvorgang mit 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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

Ersetzen Sie txcd_99999999 durch den entsprechenden Steuercode 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.

Siehe auch