# Steueridentifikationsnummern von Kundinnen und Kunden erfassen Erfahren Sie, wie Sie während des Bezahlvorgangs USt-IDs und andere Steueridentifikationsnummern von Kundinnen und Kunden erfassen. Das Angeben der Steueridentifikationsnummer und des rechtlichen Unternehmensnamens von Kundinnen und Kunden auf *Rechnungen* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) ist oft erforderlich. Sie können diese Anforderung erfüllen, indem Sie die Erfassung von Steueridentifikationsnummern in Checkout aktivieren. Die Erfassung von Steueridentifikationsnummern funktioniert mit allen Arten von Checkout-Integrationen: der gehosteten Seite, der eingebetteten Seite und dem Elements-Modus. > #### Haftungsausschluss > > Die Checkout Sessions API wurde entwickelt, um Steueridentifikationsnummern von Unternehmen zu erfassen, die in bestimmten Zuständigkeitsbereichen ähnliche Formate wie persönliche Steueridentifikationsnummern haben können. Sie müssen sicherstellen, dass bei der Verwendung dieser Funktion nur Steueridentifikationsnummern von Unternehmen angegeben werden, wie für dieses Feld vorgesehen. ## Erfassung von Steueridentifikationsnummern aktivieren [Serverseitig] Wenn die Erfassung von Steueridentifikationsnummern aktiviert ist, blendet Checkout das Formular zum Erfassen der Steueridentifikationsnummer je nach Standort Ihrer Kundin bzw. Ihres Kunden ein oder aus. Befindet sich Ihre Kundin bzw. Ihr Kunde an einem Standort, für den die Erfassung von Steueridentifikationsnummern unterstützt wird, zeigt Checkout Felder zur Eingabe der Steueridentifikationsnummer und des Namens der juristischen Person für das Unternehmen an. Falls verfügbar, verwendet Checkout die Versandadresse der Kundin bzw. des Kunden zur Bestimmung des Standorts, andernfalls wird die Rechnungsadresse verwendet. Kundinnen und Kunden können nur eine Steueridentifikationsnummer eingeben. ### Neue Kundinnen und Kunden Um die Erfassung der Steueridentifikationsnummer für neue Kund/innen zu aktivieren, legen Sie beim Erstellen einer Checkout-Sitzung [tax_id_collection[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-tax_id_collection-enabled) auf `true` fest. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "tax_id_collection[enabled]=true" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` Sie können Checkout außerdem so konfigurieren, dass ein neues [kundenseitig konfiguriertes Konto](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) oder eine neue Kundin oder ein neuer [Kunde](https://docs.stripe.com/api/customers/object.md) mit [customer_creation](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_creation) erstellt wird. In diesem Fall speichert Checkout alle während einer Sitzung erfassten Steueridentifikationsnummern in diesem neuen Konto- oder Kundenobjekt. Andernfalls sind die Informationen zur Steueridentifikationsnummer weiterhin unter [customer_details.tax_ids](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-tax_ids) verfügbar. ### Bestehende Kundinnen und Kunden #### Accounts v2 Erstellen Sie eine Checkout-Session mit einem bestehenden [v2-Konto](https://docs.stripe.com/api/v2/core/accounts/object.md), um alle während des Bezahlvorgangs erfassten Daten zur Steueridentifikationsnummer hinzuzufügen. In der Checkout-Session wird der Unternehmensname im [Identitätsobjekt](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-identity) gespeichert und die erfasste Steueridentifikationsnummer als eine mit dem Konto verknüpfte Ressource [Steueridentifikationsnummer](https://docs.stripe.com/api/tax_ids/object.md) gespeichert. > Checkout erfasst Steueridentifikationsnummern nur bei Konten, für die noch keine Steueridentifikationsnummer vorhanden ist. Sind für Konten eine oder mehrere Steueridentifikationsnummern gespeichert, zeigt Checkout das Formular zur Erfassung der Steueridentifikationsnummer nicht an, auch wenn die Erfassung der Steueridentifikationsnummer aktiviert ist. Setzen Sie beim Erstellen der Checkout-Sitzung [customer_update.name](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-name) auf `auto`, um den vorhandenen Identitätsnamen des Kontos automatisch mit Daten aus der Checkout-Sitzung zu aktualisieren. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_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 "success_url=https://example.com/success" ``` Wenn Sie keine gespeicherten Adressen für bestehende Konten haben, ermitteln Sie den Standort anhand der während des Bezahlvorgangs eingegebene Rechnungs- oder Versandadresse. Die folgende Tabelle beschreibt die verfügbaren Optionen: | **Parameter** | **Verhalten** | | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [customer_update.address](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-address) = `auto` | Verwendet die während des Bezahlvorgangs eingegebene Rechnungsadresse. Ersetzt die gespeicherten Adressen des Kontos. | | [customer_update.shipping](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-shipping) = `auto` | Verwendet die während des Bezahlvorgangs eingegebene Versandadresse. Ersetzt die gespeicherten Versandadressen des Kontos. Erfordert [shipping_address_collection](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection). | #### Customer v1 Erstellen Sie eine Checkout-Session mit einer/einem bestehenden [Kundin/Kunden](https://docs.stripe.com/api/customers/object.md), um alle während des Bezahlvorgangs erfassten Daten zur Steueridentifikationsnummer hinzuzufügen. Die Checkout-Session speichert den Unternehmensnamen als [Namen](https://docs.stripe.com/api/customers/object.md) der Kundin/des Kunden und fügt die erfasste Steueridentifikationsnummer zu [customer.tax_ids](https://docs.stripe.com/api/customers/object.md#customer_object-name) hinzu. > Checkout erfasst Steuer-IDs nur von Kundinnen/Kunden, für die noch keine Steuer-ID vorhanden ist. Ist für Kundinnen/Kunden eine oder mehrere Steuer-IDs gespeichert, zeigt Checkout das Formular zur Erfassung der Steuer-ID nicht an, auch wenn die Erfassung der Steuer-ID aktiviert ist. Setzen Sie beim Erstellen der Checkout-Sitzung [customer_update.name](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-name) auf `auto`, um den vorhandenen `Namen` der Kundin oder des Kunden automatisch mit Daten aus der Checkout-Sitzung zu aktualisieren. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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 "success_url=https://example.com/success" ``` Wenn Sie keine gespeicherten Adressen für bestehende Kundinnen und Kunden haben, ermitteln Sie den Standort anhand der während des Bezahlvorgangs eingegebene Rechnungs- oder Versandadresse. Die folgende Tabelle beschreibt die verfügbaren Optionen: | **Parameter** | **Verhalten** | | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [customer_update.address](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-address) = `auto` | Verwendet die während des Bezahlvorgangs eingegebene Rechnungsadresse. Ersetzt die zuvor gespeicherten Adressen der Kundin bzw. des Kunden. | | [customer_update.shipping](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-shipping) = `auto` | Verwendet die während des Bezahlvorgangs eingegebene Versandadresse. Ersetzt die zuvor gespeicherten Versandadressen der Kundin oder des Kunden. Erfordert [shipping_address_collection](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection). | ## Optional: Erfassung von Steueridentifikationsnummern verlangen Sie können Checkout durch Festlegen des Parameters [tax_id_collection[required]](https://docs.stripe.com/api/.md#create_checkout_session-tax_id_collection-required) optional so konfigurieren, dass das Erfassen von Steueridentifikationsnummern verpflichtend ist. Wenn der Parameter auf `if_supported` gesetzt wird, verlangt Checkout von Kundinnen und Kunden in [unterstützten Abrechnungsländern](https://docs.stripe.com/tax/checkout/tax-ids.md#supported-types) Angaben zur Steueridentifikationsnummer im Zuge der Zahlung. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "tax_id_collection[enabled]=true" \ -d "tax_id_collection[required]=if_supported" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Optional: Steueridentifikationsnummern im Zahlungsformular erfassen Wenn Sie den [Elements-Modus](https://docs.stripe.com/tax/checkout/elements.md) (`ui_mode: 'elements'`) verwenden, können Sie das [Tax ID Element](https://docs.stripe.com/js/custom_checkout/create_tax_id_element) rendern, um Steueridentifikationsnummern direkt in Ihrem Zahlungsformular zu erfassen. Anweisungen zur clientseitigen Einrichtung finden Sie im [Integrationsleitfaden für Elements](https://docs.stripe.com/tax/checkout/elements.md#render-tax-id-element). ## Angaben zur Steueridentifikationsnummer von Kundinnen und Kunden nach einer Sitzung abrufen Checkout fügt die angegebenen Steuer-IDs in das resultierende [Session](https://docs.stripe.com/api/checkout/sessions/object.md)-Objekt ein. Nach jeder abgeschlossenen Sitzung gibt Checkout ein [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed)-Ereignis aus, das Sie in einem *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests)-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](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-tax_ids)-Array der Sitzung verfügbar: ```json { "object": { "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y", "object": "checkout.session", ... "customer": {{CUSTOMER_ID}}, "customer_details": { ..."tax_ids": [ { "type": "eu_vat", "value": "FRAB123456789" } ] }, ..."tax_id_collection": { "enabled": true } ... } } ``` Checkout speichert erfasste Steueridentifikationsnummern und Unternehmensnamen im [Customer](https://docs.stripe.com/api/customers/object.md)-Objekt, wenn Sie die Checkout-Sitzung mit einem Kunden/einer Kundin verknüpfen. Checkout speichert eine erfasste Steueridentifikationsnummer unter dem Array [customer.tax_ids](https://docs.stripe.com/api/customers/object.md#customer_object-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](https://docs.stripe.com/api/tax_ids/list.md)-Ressource abrufen, indem Sie [owner.type](https://docs.stripe.com/api/tax_ids/list.md#list_tax_ids-owner-type) auf `customer` und [owner.customer](https://docs.stripe.com/api/tax_ids/list.md#list_tax_ids-owner-customer) auf die Kunden-ID festlegen. Checkout speichert den Unternehmensnamen in den Eigenschaften [name](https://docs.stripe.com/api/customers/object.md#customer_object-name) und [business_name](https://docs.stripe.com/api/customers/object.md#customer_object-business_name) des Kunden/der Kundin. Ihre Aborechnungen zeigen immer den erfassten rechtsgültigen Unternehmensnamen. ## Ihre Integration testen 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](https://docs.stripe.com/billing/customer/tax-ids.md#supported-tax-id). Sie können auch unsere [Test-Steuer-IDs](https://docs.stripe.com/connect/testing.md#test-business-tax-ids) verwenden, um verschiedene Verifizierungsabläufe zu testen. ## Validierung Während der Checkout-Session verifiziert Stripe, dass die angegebenen Steueridentifikationsnummern korrekt formatiert sind, aber nicht deren Gültigkeit. Sie sind für die Gültigkeit der während des Bezahlvorgangs erfassten Kundendaten verantwortlich. Zur Unterstützung führt Stripe automatisch eine asynchrone Validierung mit staatlichen Datenbanken für [australische Unternehmensnummern (ABNs)](https://docs.stripe.com/tax/invoicing/tax-ids.md#australian-business-numbers-abn), [EU-Umsatzsteuer-Identifikationsnummern](https://docs.stripe.com/tax/invoicing/tax-ids.md#european-value-added-tax-eu-vat-numbers) und [Umsatzsteuer-Identifikationsnummern im Vereinigten Königreich (GB-USt.)](https://docs.stripe.com/tax/invoicing/tax-ids.md#united-kingdom-value-added-tax-gb-vat-numbers) durch. Erfahren Sie mehr über die von [uns durchgeführte Validierung](https://docs.stripe.com/tax/invoicing/tax-ids.md#validation) und wie Sie den Status dieser Prüfungen aufrufen können. Wenn Sie Stripe Tax verwenden und Ihr Kunde/Ihre Kundin eine Steueridentifikationsnummer angibt, wendet Stripe Tax gemäß geltendem Recht die Umkehrung der Steuerschuldnerschaft oder den Nullsatz an, solange die Steueridentifikationsnummer unabhängig von ihrer Gültigkeit dem erforderlichen Zahlenformat entspricht. ## Unterstützte Arten von Steueridentifikationsnummern Checkout erfasst in den angegebenen Regionen derzeit folgende Steuer-ID-Typen: | Country | Enum | Description | Example | Impact in Tax Calculation* | | ------- | ---------- | --------------------------------------------------------------------------- | -------------------- | -------------------------- | | AE | ae_trn | United Arab Emirates TRN | 123456789012345 | Yes | | AL | al_tin | Albania Tax Identification Number | J12345678N | Yes | | AM | am_tin | Armenia Tax Identification Number | 02538904 | Yes | | AO | ao_tin | Angola Tax Identification Number | 5123456789 | No | | AT | eu_vat | European VAT number | ATU12345678 | Yes | | AU | au_abn | Australian Business Number (AU ABN) | 12345678912 | Yes | | AW | aw_tin | Aruba Tax Identification Number | 12345678 | Yes | | AZ | az_tin | Azerbaijan Tax Identification Number | 0123456789 | Yes | | BA | ba_tin | Bosnia and Herzegovina Tax Identification Number | 123456789012 | Yes | | BB | bb_tin | Barbados Tax Identification Number | 1123456789012 | No | | BD | bd_bin | Bangladesh Business Identification Number | 123456789-0123 | Yes | | BE | eu_vat | European VAT number | BE0123456789 | Yes | | BF | bf_ifu | Burkina Faso Tax Identification Number (Numéro d'Identifiant Fiscal Unique) | 12345678A | Yes | | BG | eu_vat | European VAT number | BG0123456789 | Yes | | BH | bh_vat | Bahraini VAT Number | 123456789012345 | Yes | | BJ | bj_ifu | Benin Tax Identification Number (Identifiant Fiscal Unique) | 1234567890123 | Yes | | BS | bs_tin | Bahamas Tax Identification Number | 123.456.789 | No | | BY | by_tin | Belarus TIN Number | 123456789 | Yes | | CA | ca_bn | Canadian BN | 123456789 | No | | CA | ca_gst_hst | Canadian GST/HST number | 123456789RT0002 | Yes | | CA | ca_pst_bc | Canadian PST number (British Columbia) | PST-1234-5678 | No | | CA | ca_pst_mb | Canadian PST number (Manitoba) | 123456-7 | No | | CA | ca_pst_sk | Canadian PST number (Saskatchewan) | 1234567 | No | | CA | ca_qst | Canadian QST number (Québec) | 1234567890TQ1234 | Yes | | CD | cd_nif | Congo (DR) Tax Identification Number (Número de Identificação Fiscal) | A0123456M | No | | CH | ch_vat | Switzerland VAT number | CHE-123.456.789 MWST | Yes | | CL | cl_tin | Chilean TIN | 12.345.678-K | Yes | | CM | cm_niu | Cameroon Tax Identification Number (Numéro d'Identifiant fiscal Unique) | M123456789000L | No | | CR | cr_tin | Costa Rican tax ID | 1-234-567890 | No | | CV | cv_nif | Cape Verde Tax Identification Number (Número de Identificação Fiscal) | 213456789 | No | | CY | eu_vat | European VAT number | CY12345678Z | Yes | | CZ | eu_vat | European VAT number | CZ1234567890 | Yes | | DE | eu_vat | European VAT number | DE123456789 | Yes | | DK | eu_vat | European VAT number | DK12345678 | Yes | | EC | ec_ruc | Ecuadorian RUC number | 1234567890001 | No | | EE | eu_vat | European VAT number | EE123456789 | Yes | | EG | eg_tin | Egyptian Tax Identification Number | 123456789 | Yes | | ES | es_cif | Spanish NIF number (previously Spanish CIF number) | A12345678 | No | | ES | eu_vat | European VAT number | ESA1234567Z | Yes | | ET | et_tin | Ethiopia Tax Identification Number | 1234567890 | Yes | | FI | eu_vat | European VAT number | FI12345678 | Yes | | FR | eu_vat | European VAT number | FRAB123456789 | Yes | | GB | eu_vat | Northern Ireland VAT number | XI123456789 | Yes | | GB | gb_vat | United Kingdom VAT number | GB123456789 | Yes | | GE | ge_vat | Georgian VAT | 123456789 | Yes | | GN | gn_nif | Guinea Tax Identification Number (Número de Identificação Fiscal) | 123456789 | Yes | | GR | eu_vat | European VAT number | EL123456789 | Yes | | HR | eu_vat | European VAT number | HR12345678912 | Yes | | HU | eu_vat | European VAT number | HU12345678 | Yes | | HU | hu_tin | Hungary tax number (adószám) | 12345678-1-23 | No | | IE | eu_vat | European VAT number | IE1234567AB | Yes | | IN | in_gst | Indian GST number | 12ABCDE3456FGZH | Yes | | IS | is_vat | Icelandic VAT | 123456 | Yes | | IT | eu_vat | European VAT number | IT12345678912 | Yes | | KE | ke_pin | Kenya Revenue Authority Personal Identification Number | P000111111A | No | | KG | kg_tin | Kyrgyzstan Tax Identification Number | 12345678901234 | No | | KH | kh_tin | Cambodia Tax Identification Number | 1001-123456789 | Yes | | KR | kr_brn | Korean BRN | 123-45-67890 | Yes | | KZ | kz_bin | Kazakhstani Business Identification Number | 123456789012 | Yes | | LA | la_tin | Laos Tax Identification Number | 123456789-000 | No | | LI | li_vat | Liechtensteinian VAT number | 12345 | Yes | | LK | lk_vat | Sri Lanka VAT number | 123456789-1234 | Yes | | LT | eu_vat | European VAT number | LT123456789123 | Yes | | LU | eu_vat | European VAT number | LU12345678 | Yes | | LV | eu_vat | European VAT number | LV12345678912 | Yes | | MA | ma_vat | Morocco VAT Number | 12345678 | Yes | | MD | md_vat | Moldova VAT Number | 1234567 | Yes | | ME | me_pib | Montenegro PIB Number | 12345678 | No | | MK | mk_vat | North Macedonia VAT Number | MK1234567890123 | Yes | | MR | mr_nif | Mauritania Tax Identification Number (Número de Identificação Fiscal) | 12345678 | No | | MT | eu_vat | European VAT number | MT12345678 | Yes | | MX | mx_rfc | Mexican RFC number | ABC010203AB9 | No | | NG | ng_tin | Nigerian Tax Identification Number | 12345678-0001 | No | | NL | eu_vat | European VAT number | NL123456789B12 | Yes | | NO | no_vat | Norwegian VAT number | 123456789MVA | Yes | | NP | np_pan | Nepal PAN Number | 123456789 | Yes | | NZ | nz_gst | New Zealand GST number | 123456789 | Yes | | OM | om_vat | Omani VAT Number | OM1234567890 | Yes | | PE | pe_ruc | Peruvian RUC number | 12345678901 | Yes | | PH | ph_tin | Philippines Tax Identification Number | 123456789012 | Yes | | PL | eu_vat | European VAT number | PL1234567890 | Yes | | PL | pl_nip | Polish NIP number | 1234567890 | No | | PT | eu_vat | European VAT number | PT123456789 | Yes | | RO | eu_vat | European VAT number | RO1234567891 | Yes | | RS | rs_pib | Serbian PIB number | 123456789 | No | | RU | ru_inn | Russian INN | 1234567891 | Yes | | RU | ru_kpp | Russian KPP | 123456789 | Yes | | SA | sa_vat | Saudi Arabia VAT | 123456789012345 | Yes | | SE | eu_vat | European VAT number | SE123456789123 | Yes | | SG | sg_gst | Singaporean GST | M12345678X | Yes | | SI | eu_vat | European VAT number | SI12345678 | Yes | | SK | eu_vat | European VAT number | SK1234567891 | Yes | | SN | sn_ninea | Senegal NINEA Number | 12345672A2 | No | | SR | sr_fin | Suriname FIN Number | 1234567890 | Yes | | TH | th_vat | Thai VAT | 1234567891234 | Yes | | TJ | tj_tin | Tajikistan Tax Identification Number | 123456789 | Yes | | TR | tr_tin | Turkish Tax Identification Number | 0123456789 | Yes | | TW | tw_vat | Taiwanese VAT | 12345678 | Yes | | TZ | tz_vat | Tanzania VAT Number | 12345678A | Yes | | UA | ua_vat | Ukrainian VAT | 123456789 | Yes | | UG | ug_tin | Uganda Tax Identification Number | 1014751879 | Yes | | UY | uy_ruc | Uruguayan RUC number | 123456789012 | Yes | | UZ | uz_tin | Uzbekistan TIN Number | 123456789 | No | | UZ | uz_vat | Uzbekistan VAT Number | 123456789012 | Yes | | ZA | za_vat | South African VAT number | 4123456789 | Yes | | ZM | zm_tin | Zambia Tax Identification Number | 1004751879 | No | | ZW | zw_tin | Zimbabwe Tax Identification Number | 1234567890 | No | \*Stripe Tax won't apply tax if this tax ID is provided, in line with the relevant laws.