Steuer-IDs mit Checkout erfassen
Häufig müssen die Steuer-ID und der rechtsgültige Firmenname von Kundinnen und Kunden auf Rechnungen ausgewiesen werden. Diese Anforderung können Sie erfüllen, indem Sie die Erfassung der Steuer-ID in Checkout aktivieren. In diesem Leitfaden wird davon ausgegangen, dass Sie Checkout bereits integriert haben. Andernfalls lesen Sie den Leitfaden.
Unterstützte Steuer-ID-Typen
Checkout erfasst in den angegebenen Regionen derzeit folgende Steuer-ID-Typen:
Land | Enum | Beschreibung | Beispiel |
---|---|---|---|
Ägypten | eg_tin | Ägyptische Steueridentifikationsnummer | 123456789 |
Australien | au_abn | Australian Business Number (AU ABN) | 12345678912 |
Bahrain | bh_vat | Bahrain, Umsatzsteuer-Identifikationsnummer | 123456789012345 |
Belgien | eu_vat | European VAT number | BE0123456789 |
Bulgarien | eu_vat | European VAT number | BG0123456789 |
Chile | cl_tin | Chilenische TIN | 12.345.678-K |
Dänemark | eu_vat | European VAT number | DK12345678 |
Deutschland | eu_vat | European VAT number | DE123456789 |
Estland | eu_vat | European VAT number | EE123456789 |
Finnland | eu_vat | European VAT number | FI12345678 |
Frankreich | eu_vat | European VAT number | FRAB123456789 |
Georgien | ge_vat | Georgische Umsatzsteuer | 123456789 |
Griechenland | eu_vat | European VAT number | EL123456789 |
Indien | in_gst | Indische GST-Nummer | 12ABCDE3456FGZH |
Irland | eu_vat | European VAT number | IE1234567AB |
Island | is_vat | Isländische Umsatzsteuer | 123456 |
Italien | eu_vat | European VAT number | IT12345678912 |
Kanada | ca_bn | Kanadische BN | 123456789 |
Kanada | ca_gst_hst | Kanadische GST/HST-Nummer | 123456789RT0002 |
Kanada | ca_pst_bc | Kanadische PST-Nummer (British Columbia) | PST-1234-5678 |
Kanada | ca_pst_mb | Kanadische PST-Nummer (Manitoba) | 123456-7 |
Kanada | ca_pst_sk | Kanadische PST-Nummer (Saskatchewan) | 1234567 |
Kanada | ca_qst | Kanadische QST-Nummer (Québec) | 1234567890TQ1234 |
Kasachstan | kz_bin | Kasachstan, Unternehmens-Identifikationsnummer | 123456789012 |
Kenia | ke_pin | Persönliche Identifikationsnummer der Kenya Revenue Authority | P000111111A |
Kroatien | eu_vat | European VAT number | HR12345678912 |
Lettland | eu_vat | European VAT number | LV12345678912 |
Litauen | eu_vat | European VAT number | LT123456789123 |
Luxemburg | eu_vat | European VAT number | LU12345678 |
Malta | eu_vat | European VAT number | MT12345678 |
Mexiko | mx_rfc | Mexikanische RFC-Nummer | ABC010203AB9 |
Neuseeland | nz_gst | Neuseeländische GST-Nummer | 123456789 |
Niederlande | eu_vat | European VAT number | NL123456789B12 |
Nigeria | ng_tin | Nigeria, Steueridentifizierungsnummer | 12345678-0001 |
Norwegen | no_vat | Norwegische Umsatzsteuer-Identifikationsnummer (USt-IdNr.) | 123456789MVA |
Oman | om_vat | Oman, Umsatzsteuer-Identifikationsnummer | OM1234567890 |
Österreich | eu_vat | European VAT number | ATU12345678 |
Polen | eu_vat | European VAT number | PL1234567890 |
Portugal | eu_vat | European VAT number | PT123456789 |
Rumänien | eu_vat | European VAT number | RO1234567891 |
Russland | ru_inn | Russische INN | 1234567891 |
Russland | ru_kpp | Russische KPP | 123456789 |
Saudi-Arabien | sa_vat | Saudi-arabische Umsatzsteuer | 123456789012345 |
Schweden | eu_vat | European VAT number | SE123456789123 |
Schweiz | ch_vat | Umsatzsteuer-Identifikationsnummer (USt-IdNr.) in der Schweiz | CHE-123.456.789 MWST |
Singapur | sg_gst | Singapurische GST | M12345678X |
Slowakei | eu_vat | European VAT number | SK1234567891 |
Slowenien | eu_vat | European VAT number | SI12345678 |
Spanien | es_cif | Spanische NIF-Nummer (früher spanische CIF-Nummer) | A12345678 |
Spanien | eu_vat | European VAT number | ESA1234567Z |
Südafrika | za_vat | Südafrikanische Umsatzsteuer-Identifikationsnummer (USt-IdNr.) | 4123456789 |
Südkorea | kr_brn | Koreanische BRN | 123-45-67890 |
Thailand | th_vat | Thailändische Umsatzsteuer | 1234567891234 |
Tschechische Republik | eu_vat | European VAT number | CZ1234567890 |
Türkei | tr_tin | Türkische Steueridentifikationsnummer | 0123456789 |
Ungarn | eu_vat | European VAT number | HU12345678 |
Vereinigte Arabische Emirate | ae_trn | Vereinigte Arabische Emirate TRN | 123456789012345 |
Vereinigtes Königreich | eu_vat | Northern Ireland VAT number | XI123456789 |
Vereinigtes Königreich | gb_vat | Umsatzsteuer-Identifikationsnummer (USt-IdNr.) im Vereinigten Königreich | GB123456789 |
Zypern | eu_vat | European VAT number | CY12345678Z |
Erfassung von Steuer-IDs aktivieren
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 des Unternehmens und des rechtsgültigen Firmennamens angezeigt. Checkout verwendet zur Standortbestimmung die Versandadresse der Kundin/des Kunden (sofern vorhanden); andernfalls wird die Rechnungsadresse der Kundin/des Kunden verwendet. Kund/innen können nur eine Steuer-ID eingeben.
Neue Kund/innen
Um die Erfassung von Steuer-IDs für neue Kund/innen zu aktivieren, legen Sie tax_id_collection[enabled]
beim Erstellen einer Checkout-Sitzung auf true
fest.
Notiz
Das obige Code-Beispiel erstellt bei aktivierter Erfassung der Steuer-ID eine Sitzung im Modus payment
. Zur Aktivierung der Erfassung der Steuer-ID im Modus subscription
nehmen Sie für Ihre Anforderung zum Erstellen einer Sitzung im Modus subscription
die gleichen grün hervorgehobenen Änderungen vor.
Sie können Checkout zusätzlich so konfigurieren, dass ein/e neue/r Kund/in für Sie mit customer_creation erstellt werden. Wenn Sie dies tun, speichert Checkout alle während einer Sitzung erfassten Steuer-ID-Informationen in diesem/dieser neuen Kund/in. Andernfalls sind die Steuerinformationen weiterhin unter customer_details.tax_ids verfügbar.
Bestehende Kund/innen
Wenn Sie beim Erstellen einer Sitzung bestehende Kund/innen übergeben, aktualisiert Checkout die Kund/innen mit allen während der Sitzung erfassten Steuer-ID-Angaben. Checkout speichert den erfassten Unternehmensnamen in der Eigenschaft Name der Kundin/des Kunden und fügt die erfasste Steuer-ID dem Array customer.tax_ids hinzu. Da die Erfassung eines Unternehmensnamens dazu führen könnte, dass der bestehende Name der Kund/innen überschrieben wird, müssen Sie customer_update[name]
beim Erstellen der Sitzung auf auto
festlegen.
Vorsicht
Checkout erfasst Steuer-IDs nur bei Kund/innen, für die noch keine Steuer-ID vorhanden ist. Ist für Kund/innen 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.
Bei der Erfassung von Steuer-IDs bestehender Kund/innen können Sie deren Standort anhand bestehender Adressen der Kund/innen oder der während des Bezahlvorgangs eingegebenen Adressen festlegen. Zur Standortbestimmung sucht Checkout standardmäßig nach bestehenden Adressen der Kund/innen:
Wenn Sie die Adresse Ihrer bestehenden Kund/innen 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 für den Zugriff auf den Kundenstandort zu verwenden, müssen Sie customer_update[address]
auf auto
festlegen.
Notiz
Wenn Sie customer_update[address]
auf auto
festgelegt haben, ersetzt Checkout alle zu den Kund/innen gespeicherten Adressen durch die während der Sitzung eingegebenen.
Wenn Sie Versandadressen für bestehende Kund/innen erfassen, muss deren Standort der während des Bezahlvorgangs eingegebenen Versandadresse entsprechen. Legen Sie hierzu customer_update[shipping]
auf auto
fest.
Notiz
Wenn Sie customer_update[shipping]
auf auto
festlegen, ersetzt Checkout alle zu den Kund/innen gespeicherten Versandadressen durch die während der Sitzung eingegebenen.
Notiz
Die obigen Code-Beispiele erstellen bei aktivierter Erfassung der Steuer-ID Sitzungen im Modus payment
. Zur Aktivierung der Erfassung der Steuer-ID im Modus subscription
nehmen Sie für Ihre Anforderung zum Erstellen einer Sitzung im Modus subscription
die gleichen grün hervorgehobenen Änderungen vor.
Abrufen der Steuer-ID-Angaben von Kund/innen nach einer Sitzung
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": [ {
Checkout speichert auch die erfassten Steueridentifikationsnummern und Unternehmensnamen im Customer-Objekt, 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 Steueridentifikationsnummern abrufen, indem Sie owner[type]
parameter 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.
Ihre Integration testen
Im Test-Modus können Sie jede alphanumerische Zeichenfolge eingeben, die das korrekte Format eines unterstützten Steuer-ID-Typs (zum Beispiel DE123456789
für eu_vat
) aufweist. Eine vollständige Liste beispielhafter Steuer-IDs finden Sie im Leitfaden zur Kundensteuer-ID. Mit unseren Test-Steuer-IDs können Sie auch verschiedene Verifizierungsabläufe testen: Test-Steuernummern für Unternehmen.
Validierung
Bezahlvorgang 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 Steueridentifikationsnummern gültig sind. Sie sind für die Gültigkeit der während des 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 zur von uns durchgeführten Validierung und zur Nutzung des Status dieser Prüfungen finden Sie in unserem Leitfaden zur Kunden-Steueridentifikationsnummer.