Steuer-IDs mit Checkout erfassen
Erfahren Sie, wie Sie mit Checkout Umsatzsteuer-IDs und andere Steuer-IDs von Kund/innen erfassen.
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, lesen Sie den Leitfaden Zahlung annehmen…
Erfassung von Steuer-IDs aktivierenServerseitig
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.
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.
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.
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.
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.
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 test mode, you can enter any alphanumeric string that is in the correct format of a supported tax ID type (for example, DE123456789
for eu_
). 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
Checkout führt während der Sitzung Prüfungen durch, um sicherzustellen, dass die angegebenen Steuer-IDs korrekt formatiert sind. Wir überprüfen nicht, ob die während der Sitzung angegebenen Steuer-IDs gültig sind. Sie sind für die Gültigkeit der beim Bezahlvorgang erfassten Kundeninformationen verantwortlich. Stripe führt zur Unterstützung automatisch eine asynchrone Validierung mit staatlichen Datenbanken für Australian Business (ABN)-Nummern, European Value-Added-Tax (EU USt.)-Nummern und United Kingdom Value-Added-Tax (GB VAT)-Nummern durch. Weitere Informationen zu der von uns durchgeführten Validierung und zur Nutzung des Status dieser Prüfungen finden Sie in unserem Leitfaden zu Steuer-IDs von Kundinnen/Kunden.
Unterstützte Steuer-ID-Typen
Die Checkout-Sitzung erfasst die folgenden Steuer-ID-Typen in den angegebenen Regionen:
Land | Enum | Beschreibung | Beispiel |
---|---|---|---|
Ägypten | eg_ | Ägyptische Steueridentifikationsnummer | 123456789 |
Albanien | al_ | Albanien Steueridentifikationsnummer | J12345678N |
Angola | ao_ | Steueridentifikationsnummer Angola | 5123456789 |
Armenien | am_ | Steueridentifikationsnummer Armenien | 02538904 |
Australien | au_ | Australian Business Number (AU ABN) | 12345678912 |
Bahamas | bs_ | Steueridentifikationsnummer Bahamas | 123.456.789 |
Bahrain | bh_ | Bahrain, Umsatzsteuer-Identifikationsnummer | 123456789012345 |
Barbados | bb_ | Steueridentifikationsnummer Barbados | 1123456789012 |
Belarus | by_ | Weißrussland TIN-Nummer | 123456789 |
Belgien | eu_ | European VAT number | BE0123456789 |
Bosnien und Herzegowina | ba_ | Steueridentifikationsnummer Bosnien und Herzegowina | 123456789012 |
Bulgarien | eu_ | European VAT number | BG0123456789 |
Chile | cl_ | Chilenische TIN | 12.345.678-K |
Costa Rica | cr_ | Costa-ricanische Steueridentifikationsnummer | 1-234-567890 |
Dänemark | eu_ | European VAT number | DK12345678 |
Deutschland | eu_ | European VAT number | DE123456789 |
Ecuador | ec_ | Ecuadorianische RUC-Nummer | 1234567890001 |
Estland | eu_ | European VAT number | EE123456789 |
Finnland | eu_ | European VAT number | FI12345678 |
Frankreich | eu_ | European VAT number | FRAB123456789 |
Georgien | ge_ | Georgische Umsatzsteuer | 123456789 |
Griechenland | eu_ | European VAT number | EL123456789 |
Guinea | gn_ | Steueridentifikationsnummer Guinea (Número de Identificação Fiscal) | 123456789 |
Indien | in_ | Indische GST-Nummer | 12ABCDE3456FGZH |
Irland | eu_ | European VAT number | IE1234567AB |
Island | is_ | Isländische Umsatzsteuer | 123456 |
Italien | eu_ | European VAT number | IT12345678912 |
Kambodscha | kh_ | Steueridentifikationsnummer Kambodscha | 1001-123456789 |
Kanada | ca_ | Kanadische BN | 123456789 |
Kanada | ca_ | Kanadische GST/HST-Nummer | 123456789RT0002 |
Kanada | ca_ | Kanadische PST-Nummer (British Columbia) | PST-1234-5678 |
Kanada | ca_ | Kanadische PST-Nummer (Manitoba) | 123456-7 |
Kanada | ca_ | Kanadische PST-Nummer (Saskatchewan) | 1234567 |
Kanada | ca_ | Kanadische QST-Nummer (Québec) | 1234567890TQ1234 |
Kasachstan | kz_ | Kasachstan, Unternehmens-Identifikationsnummer | 123456789012 |
Kenia | ke_ | Persönliche Identifikationsnummer der Kenya Revenue Authority | P000111111A |
Kongo-Kinshasa | cd_ | Steueridentifikationsnummer Republik Kongo (Número de Identificação Fiscal) | A0123456M |
Kroatien | eu_ | European VAT number | HR12345678912 |
Lettland | eu_ | European VAT number | LV12345678912 |
Liechtenstein | li_ | Umsatzsteuer-Identifikationsnummer in Liechtenstein | 12345 |
Litauen | eu_ | European VAT number | LT123456789123 |
Luxemburg | eu_ | European VAT number | LU12345678 |
Malta | eu_ | European VAT number | MT12345678 |
Marokko | ma_ | Marokko, Umsatzsteuer-Identifikationsnummer | 12345678 |
Mauretanien | mr_ | Steueridentifikationsnummer Mauretanien (Número de Identificação Fiscal) | 12345678 |
Mexiko | mx_ | Mexikanische RFC-Nummer | ABC010203AB9 |
Montenegro | me_ | Montenegro PIB-Nummer | 12345678 |
Nepal | np_ | PAN-Nummer Nepal | 123456789 |
Neuseeland | nz_ | Neuseeländische GST-Nummer | 123456789 |
Niederlande | eu_ | European VAT number | NL123456789B12 |
Nigeria | ng_ | Nigeria, Steueridentifizierungsnummer | 12345678-0001 |
Nordmazedonien | mk_ | Umsatzsteuer-Identifikationsnummer Nordmazedonien | MK1234567890123 |
Norwegen | no_ | Norwegische Umsatzsteuer-Identifikationsnummer (USt-IdNr.) | 123456789MVA |
Oman | om_ | Oman, Umsatzsteuer-Identifikationsnummer | OM1234567890 |
Österreich | eu_ | European VAT number | ATU12345678 |
Peru | pe_ | Peruanische RUC-Nummer | 12345678901 |
Polen | eu_ | European VAT number | PL1234567890 |
Portugal | eu_ | European VAT number | PT123456789 |
Republik Moldau | md_ | Republik Moldau, Umsatzsteuer-Identifikationsnummer | 1234567 |
Rumänien | eu_ | European VAT number | RO1234567891 |
Russland | ru_ | Russische INN | 1234567891 |
Russland | ru_ | Russische KPP | 123456789 |
Sambia | zm_ | Steueridentifikationsnummer Sambia | 1004751879 |
Saudi-Arabien | sa_ | Saudi-arabische Umsatzsteuer | 123456789012345 |
Schweden | eu_ | European VAT number | SE123456789123 |
Schweiz | ch_ | Umsatzsteuer-Identifikationsnummer (USt-IdNr.) in der Schweiz | CHE-123.456.789 MWST |
Senegal | sn_ | NINEA-Nummer Senegal | 12345672A2 |
Serbien | rs_ | Serbische PIB-Nummer | 123456789 |
Simbabwe | zw_ | Steueridentifikationsnummer Simbabwe | 1234567890 |
Singapur | sg_ | Singapurische GST | M12345678X |
Slowakei | eu_ | European VAT number | SK1234567891 |
Slowenien | eu_ | European VAT number | SI12345678 |
Spanien | es_ | Spanische NIF-Nummer (früher spanische CIF-Nummer) | A12345678 |
Spanien | eu_ | European VAT number | ESA1234567Z |
Südafrika | za_ | Südafrikanische Umsatzsteuer-Identifikationsnummer (USt-IdNr.) | 4123456789 |
Südkorea | kr_ | Koreanische BRN | 123-45-67890 |
Suriname | sr_ | FIN-Nummer Suriname | 1234567890 |
Tadschikistan | tj_ | Steueridentifikationsnummer Tadschikistan | 123456789 |
Taiwan | tw_ | Taiwanesische Umsatzsteuer | 12345678 |
Tansania | tz_ | Tansania, Umsatzsteuer-Identifikationsnummer | 12345678A |
Thailand | th_ | Thailändische Umsatzsteuer | 1234567891234 |
Tschechische Republik | eu_ | European VAT number | CZ1234567890 |
Türkei | tr_ | Türkische Steueridentifikationsnummer | 0123456789 |
Uganda | ug_ | Steueridentifikationsnummer Uganda | 1014751879 |
Ukraine | ua_ | Ukrainische Umsatzsteuer | 123456789 |
Ungarn | eu_ | European VAT number | HU12345678 |
Uruguay | uy_ | Uruguayische RUC-Nummer | 123456789012 |
Usbekistan | uz_ | Usbekistan, TIN-Nummer | 123456789 |
Usbekistan | uz_ | Usbekistan, Umsatzsteuer-Identifikationsnummer | 123456789012 |
Vereinigte Arabische Emirate | ae_ | Vereinigte Arabische Emirate TRN | 123456789012345 |
Vereinigtes Königreich | eu_ | Northern Ireland VAT number | XI123456789 |
Vereinigtes Königreich | gb_ | Umsatzsteuer-Identifikationsnummer (USt-IdNr.) im Vereinigten Königreich | GB123456789 |
Zypern | eu_ | European VAT number | CY12345678Z |