Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
Übersicht
Billing
ÜbersichtÜber die Billing APIs
Abonnements
Invoicing
Nutzungsbasierte Abrechnung
Angebote
Kundenverwaltung
Abrechnung mit anderen Produkten
Umsatzsicherung
Automatisierungen
Integration testen
Steuer
Übersicht
Stripe Tax verwenden
    Funktionsweise von Stripe Tax
    Inkasso einrichten
    Verhalten konfigurieren
    Tests
    Zahlungsart finden
    Unternehmenstyp finden
      Verbinden
      Ticketverkäufe
        Integrationsleitfaden
      Physische Waren
      Nutzerdefinierte Integration
    Unterstützte Länder
Compliance-Management
Berichte
Übersicht
Bericht auswählen
Berichte konfigurieren
API für Berichte
Berichte für mehrere Konten
Umsatzrealisierung
Daten
ÜbersichtSchema
Nutzerspezifische Berichte
Data Pipeline
Datenverwaltung
StartseiteUmsatzUse Stripe taxFind your business typeTicket sales

Steuerliche Ticketverkäufe je nach VeranstaltungsortPrivate Vorschau

Integrieren Sie Stripe Tax, um Steuern auf Eintrittsgelder und Tickets zu berechnen.

USt. und Verkaufssteuer fallen in der Regel überall dort an, wo Sie Eintritt erheben (z. B. bei Tickets für Konzerte, Konferenzen, Museen oder Sportveranstaltungen), basierend auf dem Veranstaltungsort und nicht auf dem Kundenstandort. In den USA können zusätzlich zu den staatlichen und lokalen Verkaufssteuern spezifische lokale Steuern (z. B. Unterhaltungs- oder Vergnügungssteuern) anfallen.

Stripe SDK aktualisieren

Diese neue Funktion ist eine private Vorschaufunktion und erfordert ein Update auf die neueste API-Version. Um die Version Ihres SDK und Ihrer API zu aktualisieren, befolgen Sie den API Upgrade-Leitfaden und aktualisieren Sie die Bibliothek auf die neueste Version. Sie können das Änderungsprotokoll überprüfen, um sicherzustellen, dass Ihre Änderungen abwärtskompatibel sind.

Bei Bedarf können Sie auf private SDK-Parameter zugreifen. Sie können auch nutzerdefinierte Anfragen in einem der folgenden SDKs verwenden, um private Endpoints im Zusammenhang mit dieser Funktion aufzurufen.

  • Ruby
  • Python
  • PHP
  • Node
  • Java
  • .NET
  • Go

Stripe Tax konfigurieren

When you set up Stripe Tax for tickets, set the default product tax code to txcd_20030000, General - Services. You can’t set any of the event tax codes as the default product tax code.

So fügen Sie eine Registrierung für Tests hinzu:

  1. Klicken Sie auf der Seite Steuerregistrierungen im Dashboard auf Registrierung hinzufügen.
  2. Fügen Sie die folgenden empfohlenen Registrierungen hinzu:
    1. Vereinigte Staaten - Colorado, Umsatzsteuer
    2. Vereinigte Staaten - Colorado, Boulder Eintrittssteuer

Für Stripe Tax-Berechnungen fallen in einer Sandbox-Umgebung keine Gebühren an. Nachdem Sie eine Steuerregistrierung hinzugefügt haben, fällt für die Berechnung der Steuer im Live-Modus eine Gebühr an.

In den meisten Fällen basiert die Steuerberechnung auf dem Transaktionsziel, bei dem es sich in der Regel um die Versand- oder Rechnungsadresse des Kunden/der Kundin handelt. Die Steuerberechnung für Ticketverkäufe basiert jedoch auf dem Veranstaltungsort. In den folgenden Schritten wird beschrieben, wie Steuern mithilfe des Veranstaltungsortes berechnet werden.

Gestalten Sie Ihren Bezahlvorgang

Stripe Tax unterstützt nur Ticketverkäufe über die Stripe Tax Calculation API. Dies bedeutet, dass Sie nur eine Integration mit Payment Elements oder direkt mit der Tax Calculation API vornehmen können. Sie können keine anderen Integrationen wie Stripe Checkout oder Stripe Subscriptions verwenden.

Unabhängig von Ihrer Zahlungsintegration können Sie zwischen zwei Integrationspfaden wählen:

Tax Payment Intent-Integration (empfohlen)Integration der manuellen Tax Calculation API
Vorteile
  • Einfacher zu integrieren.
  • Automatisierte Abwicklung von Rückerstattungen.
  • Dashboard-Unterstützung, besonders nützlich für Tests.
  • Integrierte Unterstützung von Belegen.
  • Übernimmt die volle Kontrolle über den Bezahlvorgang.
  • Sie können die Version mit anderen Zahlungsanbietern wie z. B. PayPal verwenden.
Nachteile
  • In der öffentlichen Vorschau.
  • Funktioniert nicht gut mit anderen Zahlungsanbietern wie PayPal.
  • Rückerstattungen erfordern mehr Aufwand bei der Implementierung.
  • Eingeschränkte Unterstützung des Dashboards; Das Testen ist schwieriger.
  • Belege werden nicht automatisch erstellt.

Unabhängig davon, für welche Integration Sie sich entscheiden, müssen Sie einen Steuerstandort erstellen und eine Steuerberechnung durchführen. Dies funktioniert für beide Integrationspfade auf die gleiche Weise.

Mit der Tax Location API einen Veranstaltungsort erstellen

Für jeden Ticketverkauf ist ein Steuerstandort erforderlich, den Sie erstellen und in Ihrer Datenbank speichern, um anzugeben, wann Sie die Steuern berechnen. Erstellen Sie für dieses Beispiel einen Steuerstandort vom Typ performance, der den Greenleaf Park, einen Park in Boulder, Coloardo, in den USA darstellt.

Command Line
cURL
No results
curl https://api.stripe.com/v1/tax/locations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Version: 2025-05-28.basil" \ -d type=performance \ --data-urlencode "address[line1]"="Folsom and, Pearl St" \ -d "address[city]"=Boulder \ -d "address[state]"=CO \ -d "address[postal_code]"=80302 \ -d "address[country]"=US \ -d description="Greenleaf Park"

Die Antwort enthält das Feld id. Dies ist die Kennung für den Steuerstandort, die Sie in Ihrer eigenen Datenbank speichern können.

{ "id": "taxloc_yB7b4tVHRb", // ... other fields omitted }

Das Datenbankschema könnte beispielsweise wie folgt aussehen:

IDvenue_nameFassungsvermögenSitzplan…stripe_location_id
…Greenleaf Park500https://stripe.cdn.com/seatplan.png…taxloc_yB7b4tVHRb
………………

Tabelle: your_business.venues

Steuerberechnung

Um die Steuer für Ticketverkäufe zu berechnen, benötigt Stripe Tax vier Informationen:

  • Der Standort Ihres Unternehmens (Adresse des Hauptsitzes), der über die Steuereinstellungen bereitgestellt wird und den Sie zuvor konfiguriert haben
  • Der Ort des Ereignisses (Steuerstandort vom Typ performance), erstellt im vorherigen Abschnitt
  • Der Standort der Kundin/des Kunden (Rechnungsadresse) - dies ist wichtig im Bezug auf die Umkehrung der B2B-Steuerschuld
  • Die Art des Produkts (Ticket, Merchandise usw.), z. B. txcd_50010001 – Eintritt in Vergnügungs-, Unterhaltungs- und Freizeiteinrichtungen – Teilnehmer/in.

Erfassung der Kundenadresse

Um die Kundenadresse zu erfassen, empfehlen wir Ihnen, ein Adressformular in Ihren Bezahlvorgang zu integrieren, das Kundinnen/Kunden zur Eingabe ihrer Adresse mit dem Address Element auffordert. Sehen Sie, welche Adressdaten erforderlich sind.

Sie müssen verifizieren, dass die Rechnungsadresse eine gültige Adresse für Stripe Tax ist. Um die Adresse mit Stripe Tax zu validieren, können Sie eine Steuerberechnung erstellen. Für jede Berechnung im Live-Modus fallen jedoch Gebühren an. Wir empfehlen daher, so viele Validierungen wie möglich direkt in Ihrer Integration durchzuführen.

Deaktivieren Sie die Schaltfläche „Bezahlvorgang“, bevor Sie die Adresse erfassen und validieren. Nachdem Sie die Adresse eingegeben und wir sie validiert haben, können Sie die Schaltfläche zum Bezahlen aktivieren und eine Steuerberechnung durchführen. Eine Steuerberechnung ist eine „Vorschau“ auf die anfallenden Steuern.

Produkttypen

You can find all ticket tax codes on our product tax code reference page, including txcd_50010001, Admission to Amusement, Entertainment and Recreation Venues – Participant.

Steuern mit Steuerstandorten berechnen

Sie müssen alle erforderlichen Daten innerhalb des API-Aufrufs zur Steuerberechnung übergeben. In diesem Beispiel berechnen Sie die Steuern für einen Kunden/eine Kundin mit Sitz in Irland. Dieser Kunde/Diese Kundin reist in die Vereinigten Staaten und kauft ein Ticket für eine Veranstaltung im Greenleaf Park in Boulder, Colorado.

Command Line
cURL
No results
curl https://api.stripe.com/v1/tax/calculations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Version: 2025-05-28.basil" \ -d currency=usd \ -d "line_items[0][amount]"=2500 \ -d "line_items[0][reference]"="Outdoor concert - L1" \ -d "line_items[0][tax_behavior]"=exclusive \ -d "line_items[0][tax_code]"=txcd_50010001 \ -d "line_items[0][performance_location]"=taxloc_yB7b4tVHRb \ -d "customer_details[address][country]"=IE \ -d "customer_details[address_source]"=billing

Wenn der Berechnungs-Endpoint den Fehlercode customer_tax_location_invalid zurückgibt, fordern Sie Ihre Kundinnen/Kunden auf, die eingegebene Adresse auf Richtigkeit und Vollständigkeit zu überprüfen.

Das Ergebnis der Rechnung verstehen und mit einer Zahlung verknüpfen

Der Aufruf der Calculation API berechnet die Steuern am Steuerstandort des Ereignisses. In diesem Fall der Greenleaf Park in Boulder, Colorado.

Sie können die Steueraufschlüsselung auf höchster Ebene verwenden, um alle berechneten Steuern anzuzeigen. In diesem Fall sieht die Antwort in etwa wie folgt aus:

{ "id": "taxcalc_fQSaHNaU", "amount_total": 2697, // ... other fields omitted "tax_breakdown": [ // ... other entries omitted { "amount": 125, "inclusive": false, "tax_rate_details": { // ... other entries omitted "country": "US", "state": "CO", "percentage_decimal": "5.0", // This is just an example. The Stripe Tax calculation API returns the correct tax rate. "tax_type": "admissions_tax" }, "taxability_reason": "standard_rated", "taxable_amount": 2500 } ] }

Das calculation-Objekt enthält eine ID. Jedes Mal, wenn sich einer der vier Eingabeparameter (Unternehmensstandort, Kundenadresse, Ereignisort oder Produkttyp) ändert, müssen Sie eine neue Berechnung durchführen.

Sie speichern die letzte Berechnungs-ID, um eine Steuertransaktion zu einem späteren Zeitpunkt festzuschreiben. Diese ist für eine konforme Berichterstattung erforderlich.

Ihre Bezahloberfläche kann die Steuern als Vorschau ähnlich wie im folgenden Beispiel basierend auf dem tax_breakdown-Objekt der Antwort des API-Aufrufs zur Steuerberechnung anzeigen.

College Football Rose Bowl Game 2023 am Montag 1. Jan 2025 im Rose Bowl

Bezahlvorgang – VorschauzeileBetrag
Gesamtnennwert25 USD .
MwSt. (2,90 %)0.72 USD
Zulassungssteuer (5,0 %)1.25 USD
Summe26.97 USD

Zahlung erstellen

Die Zahlung wird mit dem amount_total aus der Steuerberechnung erstellt.

Nachdem die Zahlung erfolgreich war, können Sie eine Steuertransaktion erstellen. Verwenden Sie diesen Datensatz für die Berichterstattung und Konformität.

Für die Tax Payment Intent-Integration müssen Sie die Payment Intents API verwenden. Durch Definieren des hooks-Felds können Sie die Steuerberechnungs-ID an den Payment Intent übergeben.

Dadurch wird ein Payment Intent und anschließend im Hintergrund eine Steuertransaktion erstellt.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Version: 2025-05-28.preview" \ -d amount=2697 \ -d currency=usd \ -d "automatic_payment_methods[enabled]"=true \ -d "hooks[inputs][tax][calculation]"=
{{CALCULATION_ID}}

Weitere Informationen zur Tax Payment Intent-Integration finden Sie im Integrationsleitfaden für Tax Payment Intent.

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