Steuer-IDs mit Checkout erfassen

Wenn die Erfassung von Steuer-IDs aktiviert ist, wird das Formular zur Erfassung von Steuer-IDs je nach Standort Ihrer Kundin/Ihres Kunden in Checkout angezeigt oder verborgen. Unterstützt die Erfassung von Steuer-IDs den Standort Ihrer Kundin/Ihres Kunden, wird in Checkout ein entsprechendes Kontrollkästchen angezeigt, mit dem die Kundin/der Kunde angeben kann, dass der Kauf geschäftlich ist. Wird das Kontrollkästchen aktiviert, werden in Checkout Felder zur Eingabe der Steuer-ID und des rechtsgültigen Namens des Unternehmens angezeigt. Checkout verwendet zur Standortbestimmung die Versandadresse der Kundin/des Kunden (sofern vorhanden); andernfalls wird die Rechnungsadresse der Kundin/des Kunden verwendet. Kundinnen/Kunden können nur eine Steuer-ID eingeben.

Neue Kundinnen/Kunden

Um die Erfassung von Steuer-IDs für neue Kundinnen/Kunden zu aktivieren, legen Sie tax_id_collection[enabled] beim Erstellen einer Checkout-Sitzung auf true fest.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "tax_id_collection[enabled]"=true \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

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

Sie können Checkout außerdem mithilfe von customer_creation so konfigurieren, dass ein neues in diesem neuen Konto oder für den neuen Kunden/die neue Kundin. Andernfalls sind die Steueridentifikationsnummern weiterhin unter customer_details.tax_ids verfügbar.

Bestehende Kundinnen/Kunden

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[address]"=auto \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -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 success_url="https://example.com/success"

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": __TOKEN_PLACEHOLDER_0__,
    "customer_details": {
      ...
      "tax_ids": [
        {
          "type": "eu_vat",
          "value": "FRAB123456789"
        }
      ]
    },
    ...
    "tax_id_collection": {
      "enabled": true
    },
    ...
  }
}

Checkout speichert erfasste Steueridentifikationsnummern und Unternehmensnamen im Customer-Objekt, wenn Sie die Checkout-Sitzung mit einem Kunden/einer Kundin verknüpfen. Checkout speichert eine erfasste Steueridentifikationsnummer unter dem Array customer.tax_ids für den Kunden/die Kundin. Sie können alle Steueridentifikationsnummern, die für einen Kunden/eine Kundin gespeichert sind, mit der Steueridentifikationsnummern-Ressource abrufen, indem Sie owner.type auf customer und owner.customer auf die Kunden-ID festlegen. Checkout speichert den Unternehmensnamen in den Eigenschaften name und business_name des Kunden/der Kundin. Ihre Aborechnungen zeigen immer den erfassten rechtsgültigen Unternehmensnamen.

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.