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.
Stripe Tax konfigurieren
When you set up Stripe Tax for tickets, set the default product tax code to txcd_
, 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:
- Klicken Sie auf der Seite Steuerregistrierungen im Dashboard auf Registrierung hinzufügen.
- Fügen Sie die folgenden empfohlenen Registrierungen hinzu:
- Vereinigte Staaten - Colorado, Umsatzsteuer
- 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 |
|
|
Nachteile |
|
|
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.
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:
ID | venue_name | Fassungsvermögen | Sitzplan | … | stripe_location_id |
… | Greenleaf Park | 500 | https://stripe.cdn.com/seatplan.png | … | taxloc_ |
… | … | … | … | … | … |
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_
– Eintritt in Vergnügungs-, Unterhaltungs- und Freizeiteinrichtungen – Teilnehmer/in.50010001
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_
, 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.
Wenn der Berechnungs-Endpoint den Fehlercode customer_
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_
-Objekt der Antwort des API-Aufrufs zur Steuerberechnung anzeigen.
College Football Rose Bowl Game 2023 am Montag 1. Jan 2025 im Rose Bowl
Bezahlvorgang – Vorschauzeile | Betrag |
---|---|
Gesamtnennwert | 25 USD . |
MwSt. (2,90 %) | 0.72 USD |
Zulassungssteuer (5,0 %) | 1.25 USD |
Summe | 26.97 USD |
Zahlung erstellen
Die Zahlung wird mit dem amount_
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.