Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Finanzautomatisierung
Plattformen und Marktplätze
Geldmanagement
Entwickler-Tools
Jetzt starten
Zahlungen
Finanzautomatisierung
Jetzt starten
Zahlungen
Finanzautomatisierung
Plattformen und Marktplätze
Geldmanagement
Übersicht
Informationen zu Stripe Payments
Aktualisieren Sie Ihre Integration
Zahlungsanalysefunktionen
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Payment Links verwenden
Bezahlseite erstellen
    Übersicht
    Quickstarts
    Erscheinungsbild anpassen
    Zusätzliche Informationen erfassen
    Steuern einziehen
      Verwenden Sie manuelle Steuersätze
      Steuer-IDs erfassen
    Bezahlvorgang dynamisch aktualisieren
    Ihren Produktkatalog verwalten
    Abonnements
    Zahlungsmethoden verwalten
    Lassen Sie Kundinnen/Kunden in ihrer Landeswährung zahlen
    Rabatte, Upselling und optionale Artikel hinzufügen
    Zukünftige Zahlungen einrichten
    Zahlungsdaten bei der Zahlung speichern
    Zahlungen auf Ihrem Server manuell genehmigen
    Nach der Zahlung
    Elements mit Checkout Sessions API-Änderungsprotokoll (Beta)
    Vom bisherigen Bezahlvorgang migrieren
    Bezahlvorgang auf Prices umstellen
Erweiterte Integration erstellen
In-App-Integration erstellen
Zahlungsmethoden
Zahlungsmethoden hinzufügen
Zahlungsmethoden verwalten
Schnellerer Bezahlvorgang mit Link
Zahlungsschnittstellen
Payment Links
Checkout
Web Elements
In-App-Elements
Zahlungsszenarien
Nutzerdefinierte Zahlungsabläufe
Flexibles Acquiring
Orchestrierung
Präsenzzahlungen
Terminal
Andere Stripe-Produkte
Financial Connections
Krypto
Climate
StartseiteZahlungenBuild a checkout pageCollect taxes

Steuer-IDs mit Checkout erfassen

Erfahren Sie, wie Sie mit Checkout Umsatzsteuer-IDs und andere Steuer-IDs von Kund/innen erfassen.

Seite kopieren

Die Anzeige der Steueridentifikationsnummer und des rechtsgültigen Firmennamens eines Kunden/einer Kundin auf Rechnungen ist eine häufige Anforderung, die Sie erfüllen können, indem Sie die Erfassung der Steueridentifikationsnummer aktivieren. In diesem Leitfaden wird davon ausgegangen, dass Sie Elements bereits mit der Checkout Sessions API integriert haben. Wenn Sie diese Integration noch nicht abgeschlossen haben, sehen Sie sich den Quickstart an, um loszulegen.

Haftungsausschluss

Die Checkout Sessions API wurde entwickelt, um Steuer-IDs von Unternehmen zu erfassen, die in bestimmten Ländern ähnliche Formate wie persönliche Steuer-IDs aufweisen können. Sie müssen sicherstellen, dass bei Verwendung dieser Funktion nur die für dieses Feld vorgesehenen Steuernummern von Unternehmen angegeben werden.

Erfassung von Steuer-IDs aktivieren
Serverseitig

Neue Kundinnen/Kunden

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

Command Line
cURL
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 bzw. einem bestehenden Kunden, um diese mit allen während des Bezahlvorgangs erfassten Steuer-ID-Informationen zu aktualisieren. Die Checkout-Sitzung speichert den erfassten Unternehmensnamen als Name des Kunden/der Kundin und fügt die erfasste Steueridentifikationsnummer zu customer.tax_ids hinzu. Da durch die Erfassung eines Unternehmensnamens der Name des Kunden/der Kundin überschrieben werden kann, müssen Sie customer_update.name auf auto festlegen, wenn Sie die Checkout-Sitzung erstellen.

Command Line
cURL
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 die Adressen Ihrer bestehenden Kundinnen/Kunden nicht gespeichert haben, können Sie deren Standort anhand der während des Bezahlvorgangs eingegebenen Rechnungs- oder Versandadresse festlegen. Um die während des Bezahlvorgangs eingegebene Rechnungsadresse zur Beurteilung des Kundenstandorts zu verwenden, legen Sie customer_update.address auf auto fest. Wenn Sie customer_update.address auf auto festlegen, werden alle zuvor für den Kunden/die Kundin gespeicherten Adressen durch die beim Bezahlvorgang eingegebene Adresse ersetzt.

Command Line
cURL
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 Kundinnen/Kunden erfassen, muss deren Standort der während des Bezahlvorgangs eingegebenen Versandadresse entsprechen, indem Sie customer_update.shipping auf auto festlegen. Wenn Sie customer_update.shipping auf auto fetlegen, werden alle zuvor für den Kunden/die Kundin gespeicherten Versandadressen durch die beim Bezahlvorgang eingegebene Versandadresse ersetzt.

Command Line
cURL
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 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.

Formular auf Client-Seite erstellen
Clientseitig

Erstellen Sie ein Formular in Ihrer Webanwendung und verwenden Sie updateTaxIdInfo, um den Unternehmensnamen und die Steueridentifikationsnummer der Kundin/des Kunden zu erfassen.

App.jsx
import {useState} from 'react'; import {useCheckout} from '@stripe/react-stripe-js'; // Create a constant to list out the taxID types you'd like to support in your checkout const TAX_ID_TYPES = ['au_abn', 'eu_vat', ...] as const; const TaxIdCollectionForm = () => { const [isPurchaseAsBusiness, setIsPurchaseAsBusiness] = useState(false); const [isEditing, setIsEditing] = useState(true); const [businessName, setBusinessName] = useState(''); const [taxIdType, setTaxIdType] = useState(''); const [taxIdValue, setTaxIdValue] = useState(''); const [errorMessage, setErrorMessage] = useState(''); const {updateTaxIdInfo} = useCheckout(); const validateAndUpdate = async () => { if (!businessName) { setErrorMessage('Business name is required'); return; } if (!taxIdValue) { setErrorMessage('Tax ID is required'); return; } if (!taxIdType) { setErrorMessage('Please select a tax ID type'); return; } // When all of the values are filled out, call `updateTaxIdInfo` submit it to the session. const res = await updateTaxIdInfo({ taxId: {value: taxIdValue, type: taxIdType}, businessName }); if (res.error) { setErrorMessage(res.error.message); } else { setErrorMessage(''); setIsEditing(false); } }; const handleReset = () => { setBusinessName(''); setTaxIdType(''); setTaxIdValue(''); setErrorMessage(''); }; const onIsPurchaseAsBusinessChange = async (e) => { setIsPurchaseAsBusiness(e.target.checked); if (!isPurchaseAsBusiness) { setErrorMessage(''); setIsEditing(true); // When isPurchaseAsBusiness is false, call this to clear the taxIdInfo in the session. await updateTaxIdInfo(null); } }; return ( <div className="tax-id-form"> <div className="form-row"> <input type="checkbox" id="purchaseAsBusiness" checked={isPurchaseAsBusiness} onChange={onIsPurchaseAsBusinessChange} /> <label htmlFor="purchaseAsBusiness">Purchase as business</label> </div> {isPurchaseAsBusiness && ( <> {isEditing ? ( <> <div className="form-row"> <label htmlFor="businessName">Business Name:</label> <input type="text" id="businessName" value={businessName} onChange={(e) => setBusinessName(e.target.value.trim())} placeholder="Enter business name" /> </div> <div className="form-row"> <label htmlFor="taxType">Tax ID Type:</label> <select id="taxIdType" value={taxIdType} onChange={(e) => setTaxIdType(e.target.value)} > <option value="">Select tax ID type</option> {TAX_ID_TYPES.map((t) => ( <option key={t} value={t}> {t} </option> ))} </select> </div> <div className="form-row"> <label htmlFor="taxId">Tax ID:</label> <input type="text" id="taxId" value={taxIdValue} onChange={(e) => setTaxIdValue(e.target.value.trim())} placeholder="Enter tax ID" /> </div> <div className="form-actions"> <button onClick={validateAndUpdate}>Save</button> <button onClick={handleReset}>Reset</button> </div> {errorMessage && ( <div className="error-message"> {errorMessage} </div> )} </> ) : ( <div className="tax-id-info"> <div>Business Name: {businessName}</div> <div>Tax ID Type: {taxIdType}</div> <div>Tax ID: {taxIdValue}</div> <button onClick={() => setIsEditing(true)}>Edit</button> </div> )} </> )} </div> ); };

Steuer-ID-Angaben von Kundinnen/Kunden nach einer Sitzung abrufen

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.

Integration testen

In testing environments, you can enter any alphanumeric string that is in the correct format of a supported tax ID type (for example, DE123456789 for eu_vat). For a full list of example tax IDs you can reference our Customer Tax ID guide. You can also use our test tax IDs to test various verification state flows.

Validierung

During the Checkout Session, Stripe verifies that the provided tax IDs are formatted correctly, but not that they’re valid. You’re responsible for ensuring the validity of customer information collected during checkout. To help, Stripe automatically performs asynchronous validation against government databases for European Value Added Tax (EU VAT) and United Kingdom Value Added Tax (GB VAT) numbers. Learn more about the validation we perform, and how to consume the status of those checks.

If you use Stripe Tax and your customer provides a tax ID, Stripe Tax applies the reverse charge or zero rate according to applicable laws, as long as the tax ID conforms to the necessary number format, regardless of its validity.

Unterstützte Steuer-ID-Typen

Die Checkout-Sitzung erfasst die folgenden Steuer-ID-Typen in den angegebenen Regionen:

LandEnumBeschreibungBeispiel
Auswirkungen auf die Steuerberechnung
Ägypteneg_tinÄgyptische Steueridentifikationsnummer123456789Ja
Albanienal_tinAlbanien SteueridentifikationsnummerJ12345678NJa
Angolaao_tinSteueridentifikationsnummer Angola5123456789Nein
Armenienam_tinSteueridentifikationsnummer Armenien02538904Ja
Arubaaw_tinSteueridentifikationsnummer Aruba12345678Ja
Aserbaidschanaz_tinSteueridentifikationsnummer Aserbaidschan0123456789Ja
Äthiopienet_tinSteueridentifikationsnummer Äthiopien1234567890Ja
Australienau_abnAustralian Business Number (AU ABN)12345678912Ja
Bahamasbs_tinSteueridentifikationsnummer Bahamas123.456.789Nein
Bahrainbh_vatBahrain, Umsatzsteuer-Identifikationsnummer123456789012345Ja
Bangladeschbd_binUnternehmens-Identifikationsnummer Bangladesch123456789-0123Ja
Barbadosbb_tinSteueridentifikationsnummer Barbados1123456789012Nein
Belarusby_tinWeißrussland TIN-Nummer123456789Ja
Belgieneu_vatEuropean VAT numberBE0123456789Ja
Beninbj_ifuSteueridentifikationsnummer Benin (Identifiant Fiscal Unique)1234567890123Ja
Bosnien und Herzegowinaba_tinSteueridentifikationsnummer Bosnien und Herzegowina123456789012Ja
Bulgarieneu_vatEuropean VAT numberBG0123456789Ja
Burkina Fasobf_ifuSteueridentifikationsnummer Burkina Faso (Numéro d'Identifiant Fiscal Unique)12345678AJa
Cabo Verdecv_nifSteueridentifikationsnummer Kap Verde (Número de Identificação Fiscal)213456789Nein
Chilecl_tinChilenische TIN12.345.678-KJa
Costa Ricacr_tinCosta-ricanische Steueridentifikationsnummer1-234-567890Nein
Dänemarkeu_vatEuropean VAT numberDK12345678Ja
Deutschlandeu_vatEuropean VAT numberDE123456789Ja
Ecuadorec_rucEcuadorianische RUC-Nummer1234567890001Nein
Estlandeu_vatEuropean VAT numberEE123456789Ja
Finnlandeu_vatEuropean VAT numberFI12345678Ja
Frankreicheu_vatEuropean VAT numberFRAB123456789Ja
Georgienge_vatGeorgische Umsatzsteuer123456789Ja
Griechenlandeu_vatEuropean VAT numberEL123456789Ja
Guineagn_nifSteueridentifikationsnummer Guinea (Número de Identificação Fiscal)123456789Ja
Indienin_gstIndische GST-Nummer12ABCDE3456FGZHJa
Irlandeu_vatEuropean VAT numberIE1234567ABJa
Islandis_vatIsländische Umsatzsteuer123456Ja
Italieneu_vatEuropean VAT numberIT12345678912Ja
Kambodschakh_tinSteueridentifikationsnummer Kambodscha1001-123456789Ja
Kameruncm_niuSteueridentifikationsnummer Kamerun (Numéro d'Identifiant fiscal Unique)M123456789000LNein
Kanadaca_bnKanadische BN123456789Nein
Kanadaca_gst_hstKanadische GST/HST-Nummer123456789RT0002Ja
Kanadaca_pst_bcKanadische PST-Nummer (British Columbia)PST-1234-5678Nein
Kanadaca_pst_mbKanadische PST-Nummer (Manitoba)123456-7Nein
Kanadaca_pst_skKanadische PST-Nummer (Saskatchewan)1234567Nein
Kanadaca_qstKanadische QST-Nummer (Québec)1234567890TQ1234Ja
Kasachstankz_binKasachstan, Unternehmens-Identifikationsnummer123456789012Ja
Keniake_pinPersönliche Identifikationsnummer der Kenya Revenue AuthorityP000111111ANein
Kirgisistankg_tinSteueridentifikationsnummer Kirgisistan12345678901234Nein
Kongo-Kinshasacd_nifSteueridentifikationsnummer Republik Kongo (Número de Identificação Fiscal)A0123456MNein
Kroatieneu_vatEuropean VAT numberHR12345678912Ja
Laosla_tinSteueridentifikationsnummer Laos123456789-000Nein
Lettlandeu_vatEuropean VAT numberLV12345678912Ja
Liechtensteinli_vatUmsatzsteuer-Identifikationsnummer in Liechtenstein12345Ja
Litaueneu_vatEuropean VAT numberLT123456789123Ja
Luxemburgeu_vatEuropean VAT numberLU12345678Ja
Maltaeu_vatEuropean VAT numberMT12345678Ja
Marokkoma_vatMarokko, Umsatzsteuer-Identifikationsnummer12345678Ja
Mauretanienmr_nifSteueridentifikationsnummer Mauretanien (Número de Identificação Fiscal)12345678Nein
Mexikomx_rfcMexikanische RFC-NummerABC010203AB9Nein
Montenegrome_pibMontenegro PIB-Nummer12345678Nein
Nepalnp_panPAN-Nummer Nepal123456789Ja
Neuseelandnz_gstNeuseeländische GST-Nummer123456789Ja
Niederlandeeu_vatEuropean VAT numberNL123456789B12Ja
Nigeriang_tinNigeria, Steueridentifizierungsnummer12345678-0001Nein
Nordmazedonienmk_vatUmsatzsteuer-Identifikationsnummer NordmazedonienMK1234567890123Ja
Norwegenno_vatNorwegische Umsatzsteuer-Identifikationsnummer (USt-IdNr.)123456789MVAJa
Omanom_vatOman, Umsatzsteuer-IdentifikationsnummerOM1234567890Ja
Österreicheu_vatEuropean VAT numberATU12345678Ja
Perupe_rucPeruanische RUC-Nummer12345678901Ja
Philippinenph_tinPhilippinische Steueridentifikationsnummer123456789012Ja
Poleneu_vatEuropean VAT numberPL1234567890Ja
Portugaleu_vatEuropean VAT numberPT123456789Ja
Republik Moldaumd_vatRepublik Moldau, Umsatzsteuer-Identifikationsnummer1234567Ja
Rumänieneu_vatEuropean VAT numberRO1234567891Ja
Russlandru_innRussische INN1234567891Ja
Russlandru_kppRussische KPP123456789Ja
Sambiazm_tinSteueridentifikationsnummer Sambia1004751879Nein
Saudi-Arabiensa_vatSaudi-arabische Umsatzsteuer123456789012345Ja
Schwedeneu_vatEuropean VAT numberSE123456789123Ja
Schweizch_vatUmsatzsteuer-Identifikationsnummer (USt-IdNr.) in der SchweizCHE-123.456.789 MWSTJa
Senegalsn_nineaNINEA-Nummer Senegal12345672A2Nein
Serbienrs_pibSerbische PIB-Nummer123456789Nein
Simbabwezw_tinSteueridentifikationsnummer Simbabwe1234567890Nein
Singapursg_gstSingapurische GSTM12345678XJa
Slowakeieu_vatEuropean VAT numberSK1234567891Ja
Slowenieneu_vatEuropean VAT numberSI12345678Ja
Spanienes_cifSpanische NIF-Nummer (früher spanische CIF-Nummer)A12345678Nein
Spanieneu_vatEuropean VAT numberESA1234567ZJa
Südafrikaza_vatSüdafrikanische Umsatzsteuer-Identifikationsnummer (USt-IdNr.)4123456789Ja
Südkoreakr_brnKoreanische BRN123-45-67890Ja
Surinamesr_finFIN-Nummer Suriname1234567890Ja
Tadschikistantj_tinSteueridentifikationsnummer Tadschikistan123456789Ja
Taiwantw_vatTaiwanesische Umsatzsteuer12345678Ja
Tansaniatz_vatTansania, Umsatzsteuer-Identifikationsnummer12345678AJa
Thailandth_vatThailändische Umsatzsteuer1234567891234Ja
Tschechische Republikeu_vatEuropean VAT numberCZ1234567890Ja
Türkeitr_tinTürkische Steueridentifikationsnummer0123456789Ja
Ugandaug_tinSteueridentifikationsnummer Uganda1014751879Ja
Ukraineua_vatUkrainische Umsatzsteuer123456789Ja
Ungarneu_vatEuropean VAT numberHU12345678Ja
Uruguayuy_rucUruguayische RUC-Nummer123456789012Ja
Usbekistanuz_tinUsbekistan, TIN-Nummer123456789Nein
Usbekistanuz_vatUsbekistan, Umsatzsteuer-Identifikationsnummer123456789012Ja
Vereinigte Arabische Emirateae_trnVereinigte Arabische Emirate TRN123456789012345Ja
Vereinigtes Königreicheu_vatNorthern Ireland VAT numberXI123456789Ja
Vereinigtes Königreichgb_vatUmsatzsteuer-Identifikationsnummer (USt-IdNr.) im Vereinigten KönigreichGB123456789Ja
Zyperneu_vatEuropean VAT numberCY12345678ZJa
War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc