Steuern einziehen

So beginnen Sie mit der Steuererhebung:

1. Übergeben Sie beim Erstellen einer Checkout-Sitzung automatic_tax[enabled]=true.
2. Geben Sie für jeden Posten einen tax_code an oder legen Sie im Dashboard einen voreingestellten Steuer-Code fest.
3. Geben Sie für jeden Posten ein tax_behavior an oder legen Sie im Dashboard ein Standard-Steuerverhalten fest.

Dieser Code ermöglicht die automatische Steuerberechnung mit Stripe Tax, einem Steuer-Code und einem Steuerverhalten. Stripe Tax verwendet dann den Steuer-Code und das Steuerverhalten, um Steuern automatisch zu berechnen.

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][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][product_data][tax_code]"=txcd_99999999 \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][tax_behavior]"=exclusive \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  -d return_url={{RETURN_URL}} \
  -d "automatic_tax[enabled]"=true

Steuercodes

Die Steuer-Codes verknüpfen Produkte mit Steuersätzen. Wählen Sie den entsprechenden Steuer-Code für Ihr Produkt aus der Liste der Steuer-Codes. Wenn ein Produkt nicht mit einem der Steuer-Codes übereinstimmt, können Sie einen der General-Codes verwenden.

Steuerverhalten

Das Steuerverhalten bestimmt, wie die Steuern für die Kund/innen dargestellt werden:

• Exklusive: Der Produktpreis beinhaltet keine Steuern. Die Steuer wird als separater Betrag hinzugefügt.
• Inklusive: Der Produktpreis beinhaltet etwaige Steuerbeträge.

Neue Kund/innen

Um die Erfassung der Steueridentifikationsnummer für neue Kund/innen zu aktivieren, legen Sie beim Erstellen einer Checkout-Sitzung tax_id_collection[enabled] auf true fest.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

Bestehende Kund/innen

Erstellen Sie eine Checkout-Sitzung mit einer bestehenden Kundin, um alle während des Bezahlvorgangs erfassten Steueridentifikationsnummern hinzuzufügen. Die Sitzung speichert den Unternehmensnamen als Namen der Kundin und fügt die erfasste Steueridentifikationsnummer zu customer.tax_ids hinzu.

Beim Anlegen der Checkout Session können Sie customer_update.name auf auto setzen, um den vorhandenen Namen der Kundin/des Kunden automatisch mit Details aus der Sitzung zu aktualisieren.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

Wenn Sie keine Adressen für bestehende Kund/innen gespeichert haben, können Sie deren Standort anhand der beim Bezahlvorgang eingegebenen Abrechnungs- oder Versandadresse beurteilen. Um die Rechnungsadresse zu verwenden, setzen Sie customer_update.address auf auto. Wenn Sie diesen Parameter auf auto setzen, werden die zuvor gespeicherten Adressen der Kund/innen durch die beim Bezahlvorgang eingegebene Adresse ersetzt.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[address]"=auto \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

Wenn Sie Versandadressen für bestehende Kund/innen speichern, können Sie deren Standort anhand der während des Bezahlvorgangs eingegebenen Versandadresse beurteilen. Um die Versandadresse zu verwenden, setzen Sie customer_update.shipping auf auto. Wenn Sie diesen Parameter auf auto setzen, werden die zuvor gespeicherten Versandadressen der Kund/innen durch die während des Bezahlvorgangs eingegebene Adresse ersetzt.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[shipping]"=auto \
  -d "shipping_address_collection[allowed_countries][0]"=DE \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

Mit diesem Beispiel wird eine Sitzung im Modus payment mit aktivierter Erfassung der Steueridentifikationsnummer erstellt. Nehmen Sie für Abos die gleichen Änderungen vor, wobei der Modus auf subscription festgelegt ist.

Verwenden Sie das Tax ID Element von Stripe, um Steueridentifikationsnummern zu erfassen.

import {useMemo} from 'react',
import {loadStripe} from '@stripe/stripe-js';
import {CheckoutProvider, TaxIdElement} from '@stripe/react-stripe-js/checkout';

const stripePromise = loadStripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx', {
  betas: [
    'custom_checkout_tax_id_1',
  ],
});

const App = () => {
  const fetchClientSecret = useMemo(() => {
    return fetch('/create-checkout-session', {method: 'POST'})
      .then((res) => res.json())
      .then((data) => data.clientSecret)
  }, []);

  return (
    <CheckoutProvider
      stripe={stripePromise}
      options={{
        clientSecret: fetchClientSecret,
      }}
    >
      <TaxIdElement />
    <CheckoutProvider>
  );
};

Checkout fügt die angegebenen Steuer-IDs in das resultierende Session-Objekt ein. Nach jeder abgeschlossenen Sitzung gibt Checkout ein checkout.session.completed-Ereignis aus, das Sie in einem Webhook-Endpoint überwachen können. Wenn Sie die erfasste Steuer-ID aus dem Session-Objekt abrufen möchten, ist sie unter dem customer_details.tax_ids-Array der Sitzung verfügbar:

{
  "object": {
    "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y",
    "object": "checkout.session",
    ...
    "customer": "cus_id_of_new_customer",
    "customer_details": {
      ...
      "tax_ids": [
        {
          "type": "eu_vat",
          "value": "FRAB123456789"
        }
      ]
    },
    ...
    "tax_id_collection": {
      "enabled": true
    },
    ...
  }
}

Checkout speichert auch die erfassten Steueridentifikationsnummern und Unternehmensnamen im Kundenobjekt, wenn eines mit der Sitzung verknüpft ist. Auf eine während des Bezahlvorgangs erfasste Steueridentifikationsnummer kann unter dem customer.tax_ids-Array der Kundin/des Kunden zugegriffen werden. Sie können außerdem alle mit einer Kundin/einem Kunden verknüpften Steueridentifikationsnummern mit der Ressource Steuer-IDs abrufen, indem Sie den Parameter owner.type auf customer festlegen und für owner.customer die ID der Kundin/des Kunden angeben. Jede neue Steueridentifikationsnummer enthält einen zugehörigen rechtsgültigen Firmennamen, den Checkout in der Eigenschaft Name der Kundin/des Kunden speichert. Auf diese Weise ist der erfasste rechtsgültige Firmenname immer auf allen Abonnementrechnungen für diese Kundin/diesen Kunden sichtbar.

In Testumgebungen können Sie jede alphanumerische Zeichenfolge eingeben, die das korrekte Format eines unterstützten Steuer-ID-Typs (z. B. DE123456789 für eu_vat) aufweist. Eine vollständige Liste beispielhafter Steuer-IDs finden Sie im Leitfaden zur Kundensteuer-ID. Sie können auch unsere Test-Steuer-IDs verwenden, um verschiedene Verifizierungsabläufe zu testen.