Steuern einziehen

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.

Um Steuern für eine bestehende Checkout-Sitzung eines/einer Kund/in zu berechnen, setzen Sie den Parameter automatic_tax[enabled] auf true, wenn Sie die Sitzung erstellen. Sie können die Steuerberechnungen auf der Grundlage der vorhandenen Adressen des/der Kund/in oder der neuen Adressen, die Sie bei der Kaufabwicklung erfasst haben, durchführen:

Vorhandene Adressen der Kund/innen für Steuern verwenden

Wenn Sie die Adressen Ihrer bestehenden Kund/innen bereits erfasst haben, können Sie die Steuerberechnungen basierend auf diesen Adressen durchführen, statt die beim Bezahlvorgang erfassten Adressen zu verwenden:

• Welche Kundenadresse verwendet Checkout für Steuern?

  Falls verfügbar, verwendet Checkout die gespeicherte Versandadresse des Kunden/der Kundin zur Berechnung der Steuern. Andernfalls verwendet Checkout die gespeicherte Rechnungsadresse des Kunden/der Kundin zur Berechnung der Steuern.

• Müssen die Kundenadressen bestimmte Anforderungen erfüllen?

  Wenn Sie vorhandene Adressen für Steuern verwenden, muss für die Kundin/den Kunden entweder eine gültige Versandadresse oder eine gültige Rechnungsadresse gespeichert sein. Ob die gespeicherten Adressen einer Kundin/eines Kunden gültig sind, ermitteln Sie, indem Sie ihre Eigenschaft customer.tax.automatic_tax überprüfen. Wenn der Wert für customer.tax.automatic_tax supported oder not_collecting ist, sind die gespeicherten Kundenadressen gültig, und Sie können Stripe Tax für Checkout-Sitzungen für diese Kundin/diesen Kunden aktivieren.

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 mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Beim Bezahlvorgang erfasste Adressen für Steuern verwenden

Sie können Checkout so konfigurieren, dass eine neue Rechnungs- oder Versandadresse eines Kunden/einer Kundin gespeichert wird. In diesem Fall berechnet Checkout die Steuern unter Verwendung der beim Bezahlvorgang eingegebenen Adresse.

• Welche Adresse verwendet Checkout für Steuern?

  Wenn Sie Versandadressen erfassen, verwendet Checkout die während der Sitzung eingegebene Versandadresse zur Berechnung der Steuern. Andernfalls verwendet Checkout die während der Sitzung eingegebene Rechnungsadresse zur Berechnung der Steuern.

• Wo werden die beim Bezahlvorgang erfassten Adressen gespeichert?

  Wenn Sie Versandadressen erfassen, speichert Checkout die während der Sitzung eingegebene Versandadresse der Kundin/des Kunden in der Eigenschaft customer.shipping.address. Andernfalls speichert Checkout die während der Sitzung eingegebene Rechnungsadresse der Kundin/des Kunden in der Eigenschaft customer.address. In beiden Fällen setzt die für Steuern verwendete Adresse alle vorhandenen Adressen außer Kraft.

Wenn Sie Versandadressen mit Checkout erfassen, setzen Sie die Eigenschaft customer_update[shipping] auf auto. Auf diese Weise können Sie die Versandinformationen von Checkout zu dem Kunden/der Kundin kopieren.

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 \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Wenn Sie keine Versandadressen mit Checkout erfassen und die beim Bezahlvorgang eingegebenen Rechnungsadressen für Steuern verwenden möchten, müssen Sie die Rechnungsadresse für den Kunden/die Kundin speichern. Setzen Sie die Eigenschaft customer_update[address] auf auto, um die neu eingegebene Adresse in den angegebenen Kunden zu kopieren.

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 mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Damit Sie die Ergebnisse der neuesten Steuerberechnung sehen können, zeigt die Eigenschaft total_details.amount_tax in der Checkout-Sitzungsressource den berechneten Steuerbetrag an. Darüber hinaus können Sie das Dashboard verwenden, um das Steuerergebnis für jede Zahlung anzuzeigen.