Steueridentifikationsnummer-ElementÖffentliche Vorschau

Das Steueridentifikationsnummernelement ist eine einbettbare UI-Komponente, die Informationen zu Steueridentifikationsnummern von Kundinnen und Kunden erfasst. Sie können das Steueridentifikationsnummernelement mit den Elementen mit Checkout Sessions API oder den Payment Intents API-Integrationen verwenden.

Details dazu, wie Sie das Steueridentifikationsnummernelement integrieren, finden Sie im Leitfaden zur Integration für Ihren gewählten Ansatz:

• Leitfaden zur Integration der Checkout Sessions API
• Integrationsleitfaden für die Payment Intents API

Wenn Sie die Demo nicht sehen, versuchen Sie, diese Seite in einem unterstützten Browser anzuzeigen.

Unterstützte Regionen

Das Steueridentifikationsnummer-Element unterstützt die Erhebung von Steueridentifikationsnummern in den folgenden Ländern und Regionen. Wenn Sie den automatischen Modus verwenden, wird das Element automatisch nur für Kundinnen/Kunden an diesen unterstützten Standorten angezeigt. Jede Region hat spezifische Anforderungen an die Steueridentifikationsnummern und das Format.

Wenn Sie das Steueridentifikationsnummerlement und das Adresselement zusammen verwenden, bestimmt Stripe automatisch den Typ der Steueridentifikationsnummer und die Sichtbarkeit des Elements anhand der Adresse der Kundin/des Kunden. Dadurch wird sichergestellt, dass das richtige Format der Steueridentifikationsnummer für den Standort der Kundin/des Kunden angezeigt wird.

Sichtbarkeit des Steueridentifikationsnummer-Elements

Sie können Steueridentifikationsnummern aus verschiedenen Gründen erfassen. Meistens tun Sie dies, um die Sales Tax zu berechnen oder auf Rechnungen auszuweisen.

Das Steueridentifikationsnummer-Element passt sich standardmäßig an den Standort einer Kundin/eines Kunden an und wird nur angezeigt, wenn der Einzug der Steueridentifikationsnummer im jeweiligen Land üblich ist. Um festzustellen, ob die Steueridentifikationsnummer relevant ist, prüft das Steueridentifikationsnummer-Element die IP-Adresse und das Land der Kundin/des Kunden aus dem Address-Element (entweder im Versand- oder Abrechnungsmodus). Wenn das Address-Element nicht vorhanden ist, verwenden wir die IP-Adresse der Kundin/des Kunden. Wenn Sie sicherstellen möchten, dass das Steueridentifikationsnummer-Element immer angezeigt wird (auch für Länder, die normalerweise keine Steueridentifikationsnummern erfassen), können Sie die Sichtbarkeit auf always einstellen.

Steueridentifikationsnummer-Element erstellen

<div class="tax-id-form">
  <div id="tax-id-element"></div>
</div>

const stripe = window.Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx', {
  betas: [
    'custom_checkout_tax_id_1',
  ],
});
const appearance = { /* appearance */ };
const elementsOptions = { appearance };

const clientSecret = fetch('/create-checkout-session', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
  })
    .then((res) => res.json())
    .then((res) => {
      return res.clientSecret;
    });

const checkout = stripe.initCheckout({
  clientSecret,
  elementsOptions
});

const taxIdElementOptions = {
  visibility: 'always',
};
const taxIdElement = checkout.createTaxIdElement(taxIdElementOptions);
taxIdElement.mount('#tax-id-element');