# Steueridentifikationsnummern von Kundinnen und Kunden erfassen Verwenden Sie das Tax ID-Element, um Steueridentifikationsnummern von Unternehmen von Kundinnen und Kunden in Ihrer PaymentIntents-Integration zu erfassen. ## Steueridentifikationsnummern von Kundinnen und Kunden erfassen Die Anzeige der Steueridentifikationsnummer und des rechtlichen Unternehmensnamens einer Kundin/eines 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 eine gängige Anforderung. Sie können das [Steueridentifikationsnummern-Element](https://docs.stripe.com/elements/tax-id-element.md) verwenden, um diese Informationen zu erfassen. Diese Funktion befindet sich in der [öffentlichen Vorschau](https://docs.stripe.com/release-phases.md). > #### Haftungsausschluss > > Die Payment Intents 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. ### Beta aktivieren Für das Steueridentifikationsnummernelement mit der Payment Intents API müssen Sie die Beta `elements_tax_id_1` aktivieren. Fügen Sie Beta zu Ihrer Stripe.js-Initialisierung hinzu: ```javascript const stripe = Stripe('<>', { betas: ['elements_tax_id_1'], }); ``` ### Erstellen Sie eine CustomerSession (optional) Um Steueridentifikationsnummern zu speichern und für wiederkehrende Kundinnen und Kunden erneut anzuzeigen, erstellen Sie eine [CustomerSession](https://docs.stripe.com/api/customer_sessions.md), die einen sicheren, vorübergehenden Zugriff auf die Kundendaten bietet, ohne Ihren geheimen API-Schlüssel dem Client gegenüber offenzulegen. Wenn Sie die `CustomerSession` nicht verwenden, funktioniert das Tax ID Element weiterhin, jedoch ohne Speicher- und Wiederanzeigefunktionen. Sie können [getValue](https://docs.stripe.com/js/elements_object/get_value_tax_id_element) verwenden, um die Werte der Steueridentifikationsnummern aus dem Element auszulesen und manuell zu verarbeiten. #### Customer v1 Erstellen oder Abrufen einer/eines *Kundin/Kunden* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments): ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=customer@example.com" \ -d "name=Jenny Rosen" ``` Erstellen einer `CustomerSession` mit aktivierter Komponente des Tax ID Elements: ```curl curl https://api.stripe.com/v1/customer_sessions \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview" \ -d "customer={{CUSTOMER_ID}}" \ -d "components[tax_id_element][enabled]=true" \ -d "components[tax_id_element][features][tax_id_redisplay]=enabled" \ -d "components[tax_id_element][features][tax_id_save]=enabled" ``` Die `CustomerSession` gibt ein `client_secret` zurück, das Sie an den Client übergeben. ### PaymentIntent oder SetupIntent erstellen Erstellen Sie einen [PaymentIntent](https://docs.stripe.com/api/payment_intents.md) oder einen [SetupIntent](https://docs.stripe.com/api/setup_intents.md) auf Ihrem Server. Fügen Sie bei Verwendung der `CustomerSession` den Kunden-Referenzparameter ein, um die Speicherung der Steueridentifikationsnummer zu aktivieren und die Funktionalität erneut anzuzeigen: #### Customer v1 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1099 \ -d currency=usd \ -d "customer={{CUSTOMER_ID}}" ``` > Sie müssen beim Erstellen des Payment Intents oder des Setup Intents keine für die Steueridentifikationsnummer spezifischen Parameter angeben. Das Tax ID Element übernimmt automatisch die Erfassung der Steueridentifikationsnummer und speichert sie für die/den *Kundin/Kunden* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments), wenn eine Kundensitzung mit den entsprechenden Berechtigungen vorhanden ist. ### Initialisieren Sie Elements Erstellen Sie eine Elements-Instanz mit dem `clientSecret` aus Ihrem PaymentIntent oder SetupIntent. Um Steueridentifikationsnummern für eine Kundin/einen Kunden zu speichern und für wiederkehrende Kundinnen/Kunden erneut anzuzeigen, fügen Sie das `customerSessionClientSecret` ein: ```javascript const stripe = Stripe('<>', { betas: ['elements_tax_id_1'], }); // Fetch the clientSecret from your server const {clientSecret} = await fetch('/create-payment-intent', { method: 'POST', headers: { 'Content-Type': 'application/json' }, }).then((res) => res.json()); // Fetch the customerSessionClientSecret from your server const {customerSessionClientSecret} = await fetch('/create-customer-session', { method: 'POST', headers: { 'Content-Type': 'application/json' }, }).then((res) => res.json()); const elements = stripe.elements({ clientSecret,customerSessionClientSecret, appearance: { /* ... */ } }); ``` ### Steueridentifikationsnummernelement erstellen und verbinden Erstellen Sie eine Instanz des Steueridentifikationsnummernelements und binden Sie sie in Ihre Seite ein: ```html
``` ```javascript const taxIdElement = elements.create('taxId', { visibility: 'auto', // 'auto' | 'always' | 'never' }); taxIdElement.mount('#tax-id-element'); ``` Sie können das Steueridentifikationsnummer-Element mit Optionen wie `visibility`, `fields` und `validation` anpassen. Weitere Informationen finden Sie unter [Erstellen eines Steueridentifikationsnummer-Elements](https://docs.stripe.com/js/elements_object/create_tax_id_element). ### Verwendung mit dem Adresselement (optional) Wenn Sie das Steueridentifikationsnummernelement zusammen mit dem [Adresselement](https://docs.stripe.com/elements/address-element.md) verwenden, ermittelt Stripe automatisch die Art der Steueridentifikationsnummer und das Element anhand der Adresse der Kundin/des Kunden. ### Zahlung abschließen Wenn die Kundin/der Kunde das Zahlungsformular absendet, rufen Sie [confirmPayment](https://docs.stripe.com/js/payment_intents/confirm_payment) oder [confirmSetup](https://docs.stripe.com/js/setup_intents/confirm_setup) auf. Stripe übernimmt automatisch die Steueridentifikationsnummer und speichert sie bei erfolgreicher Zahlung für die Kundin/den Kunden: ```javascript const form = document.getElementById('payment-form'); form.addEventListener('submit', async (event) => { event.preventDefault(); const {error} = await stripe.confirmPayment({ elements, confirmParams: { return_url: 'https://example.com/order/complete', }, }); if (error) { // Handle error console.error(error.message); } // Customer gets redirected to return_url if successful }); ``` Sie können [getValue](https://docs.stripe.com/js/elements_object/get_value_tax_id_element) auch auf Client-Seite verwenden, um die Steueridentifikationsnummern vor der Übermittlung der Zahlung zu lesen. ### 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. ### Asynchrone Validierung der Steueridentifikationsnummer Während der Zahlung oder Einrichtungsbestätigung verifiziert Stripe, dass die angegebenen Steueridentifikationsnummern korrekt formatiert sind, jedoch nicht deren Gültigkeit wird. Sie sind dafür verantwortlich, die Gültigkeit der Kundendaten sicherzustellen. 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) (EU-USt.) und [Umsatzsteuer-Identifikationsnummern](https://docs.stripe.com/tax/invoicing/tax-ids.md#united-kingdom-value-added-tax-gb-vat-numbers) im Vereinigten Königreich (GB-USt.) 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. ### Validierung der Steueridentifikationsnummer in Echtzeit (Preview) Zusätzlich zu der oben beschriebenen asynchronen Validierung können Sie die synchrone Echtzeit-Verifizierung der Steueridentifikationsnummer direkt im Element „Steueridentifikationsnummer“ aktivieren. Wenn Sie diese aktivieren, verifiziert Stripe Steueridentifikationsnummern anhand staatlicher Datenbanken, während Ihre Kundin/Ihr Kunde Eingaben macht und das Ergebnis inline anzeigt, bevor sie/er die Zahlung übermitteln. Stripe unterstützt derzeit die Echtzeit-Verifizierung für [australische Unternehmensnummern (ABNs)](https://docs.stripe.com/tax/invoicing/tax-ids.md#australian-business-numbers-abn), die [europäische Umsatzsteuer (EU VAT) ](https://docs.stripe.com/tax/invoicing/tax-ids.md#european-value-added-tax-eu-vat-numbers)und [USt.-Steuernummern des Vereinigten Königreichs](https://docs.stripe.com/tax/invoicing/tax-ids.md#united-kingdom-value-added-tax-gb-vat-numbers). Wenn eine staatliche Datenbank nicht verfügbar ist, greift Stripe auf die synchrone Formatvalidierung zurück und führt die vollständige Verifizierung asynchron durch. Diese Funktion befindet sich in der [öffentlichen Vorschau](https://docs.stripe.com/release-phases.md) und erfordert die `elements_tax_id_verification_1`-Betaversion. ```javascript const taxIdElement = elements.create('taxId', { ... verification: { taxId: { mode: 'if_supported', }, }, }); ``` Wenn Sie die Verifizierung aktivieren, enthält das `change`-Ereignis das Feld `verification.taxId.status`. Sein Wert kann `pending`, `verified`, `unverified` oder `unavailable` sein. Der Status `complete` des Elements spiegelt das Verifizierungsergebnis wider. Weitere Informationen finden Sie unter [Ein Steueridentifikationsnummer-Element erstellen](https://docs.stripe.com/js/elements_object/create_tax_id_element#tax_id_element_create-options-verification) und [Steueridentifikationsnummer-Element in der Änderung](https://docs.stripe.com/js/element/events/on_change?type=taxIdElement#element_on_change-handler-verification). ### Unterstützte Steuer-ID-Typen Das Steueridentifikationsnummernelement unterstützt die Erfassung von Steueridentifikationsnummern in den folgenden Ländern und Regionen: | 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. ### Steueridentifikationsnummer in Berechnungen verwenden (optional) In einigen Fällen, wie etwa bei grenzüberschreitenden Dienstleistungen, muss Ihre Kundin/Ihr Kunde die Steuer möglicherweise auf [Reverse Charge](https://docs.stripe.com/tax/zero-tax.md#reverse-charges)-Basis abrechnen. Anstatt die Steuer einzuziehen, müssen Sie eine Rechnung mit dem Text „Umkehrung der Steuerschuld“ ausstellen. Wenn Sie die [Steueridentifikationsnummern](https://docs.stripe.com/api/tax/calculations/create.md#calculate_tax-customer_details-tax_ids) Ihrer Kundin/Ihres Kunden an Stripe Tax übermitteln, ermitteln wir automatisch, wann die Umkehrung der Steuerschuld angewendet werden muss: ```curl curl https://api.stripe.com/v1/tax/calculations \ -u "<>:" \ -d currency=usd \ -d "line_items[0][amount]=1000" \ -d "line_items[0][reference]=L1" \ -d "customer_details[address][country]=IE" \ -d "customer_details[address_source]=billing" \ -d "customer_details[tax_ids][0][type]=eu_vat" \ -d "customer_details[tax_ids][0][value]=DE123456789" ``` Wenn Sie eine Steueridentifikationsnummer mit einem ungültigen Format angeben, gibt die Berechnung den Fehlercode `tax_id_invalid` zurück. ## See also - [Stripe Tax mit PaymentIntents](https://docs.stripe.com/tax/payment-intent.md) - [Validierung der Steueridentifikationsnummer von Kunden/Kundinnen](https://docs.stripe.com/billing/customer/tax-ids.md) - [Reverse Charges](https://docs.stripe.com/tax/zero-tax.md#reverse-charges)