Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

Tax für Software-Plattformen

Erfahren Sie, wie Sie Stripe Tax für Ihre verbundenen Konten aktivieren und Steuern erheben, wenn das verbundene Konto steuerpflichtig ist.

Mit Stripe Tax können Unternehmen indirekte Steuern in über 100 Ländern mit Hunderten von Produktkategorien berechnen, erheben und melden. Als Plattform können Sie mit Stripe Tax Ihren verbundenen Konten vorab integrierte Steuerkonformität anbieten.

Verwenden Sie diesen Leitfaden, wenn Ihre verbundenen Konten für die Erhebung, Einreichung und Meldung von Steuern verantwortlich sind.

  1. Richten Sie Ihre verbundenen Konten für Steuern ein
  2. (Optional) Dem Produktkatalog Steuercodes zuweisen
  3. Steuerberechnung und -erhebung integrieren
  4. Zugriff auf Stripe Tax-Berichte

Verbundenen Konten für Steuern einrichten

Als Plattform müssen Sie sicherstellen, dass die Steuereinstellungen und Registrierungen eines verbundenen Kontos eingerichtet sind, bevor Sie Steuerberechnungen aktivieren können. Dies kann erreicht werden:

Mit einem verbundenen Konto, das das Stripe-Dashboard nutzt

Diese Option ist nur für verbundene Konten mit Zugriff auf das Stripe-Dashboard verfügbar (z. B. Standard-Konten). Bitten Sie Ihre verbundenen Konten, ihren Hauptsitz, ihre voreingestellten Steuercodes und ihre Steuerregistrierungen über das Stripe-Dashboard hinzuzufügen. Sie können den Standort des Hauptsitzes und den voreingestellten Steuercode auch erfassen, indem Sie Stripe Tax im Onboarding des verbundenen Kontos aktivieren. Diese Änderungen können Sie in den Onboarding-Optionen für Connect im Dashboard vornehmen.

Indem Sie eine Steueroberfläche innerhalb Ihrer Plattform erstellen

Mit dieser Option können Konten ohne Zugriff auf das Stripe-Dashboard (zum Beispiel Custom- und Express-Konten) Stripe Tax konfigurieren.

Ihre Plattform muss eine Schnittstelle erstellen und die Tax Settings API verwenden, um den Hauptsitz und andere Standardwerte für die verbundenen Konten festzulegen. Und Ihre Plattform muss die Tax Registrations API verwenden, um Steuerregistrierungen für die Standorte hinzuzufügen, an denen die verbundenen Konten steuerpflichtig sind.

Verwendung eingebetteter Connect-Komponenten innerhalb Ihrer Plattform

Sie können eingebettete Connect-Komponenten nutzen, um Ihren verbundenen Konten mit minimalem Entwicklungsaufwand eine konforme Integration von Stripe Tax zu ermöglichen. Stripe aktualisiert die Integration der eingebetteten Komponenten regelmäßig. Sie sind daher hinsichtlich der Einhaltung der Steuervorschriften stets auf dem aktuellen Stand.

Stripe bietet zwei Komponenten für Tax:

  • Steuereinstellungen: Erfassen Sie die Details, die ein verbundenes Konto zur Berechnung der Steuern benötigt, wie z. B. die Adresse des Hauptsitzes und den voreingestellten Steuercode.
  • Steuerregistrierungen: Verbundene Konten können die Standorte verwalten, an denen sie sich bei lokalen Steuerbehörden registriert haben. Durch das Hinzufügen einer Registrierung kann Stripe Steuerbeträge für einen bestimmten Standort berechnen und erheben.

So betten Sie Steuereinstellungen und Steuerregistrierungen in Ihre Website ein:

  1. Verwenden Sie den Quickstart-Leitfaden für eingebettete Komponenten, um Ihre Umgebung einzurichten.

  2. Erstellen Sie eine AccountSession mit tax_settings: {enabled: true} und/oder tax_registrations: {enabled: true}.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account={{CONNECTED_ACCOUNT_ID}} \
  -d "components[tax_settings][enabled]"=true \
  -d "components[tax_registrations][enabled]"=true
  1. Fügen Sie die Komponente für die Steuereinstellungen oder die Steuerregistrierungen zum DOM hinzu.

Nachdem die Kontositzung erstellt und ConnectJS initiiert wurde, können Sie jede Steuerkomponente im Frontend anzeigen:

taxPage.jsx
React
HTML + JavaScript
No results
// Include this React component
import {
  ConnectTaxSettings,
  ConnectTaxRegistrations,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      {/* You can also use a tab layout */}
      <div>
        <h2>Tax Business Details</h2>
        <ConnectTaxSettings />
      <div>
      <div style={{ marginTop: "12px" }}>
        <h2>Tax Registrations</h2>
        <ConnectTaxRegistrations />
      <div>
    </div>
  </ConnectComponentsProvider>
);

Vorschau der Komponente für Steuereinstellungen

Mit der Komponente für Steuereinstellungen können verbundene Konten die Adresse ihres Hauptsitzes und einen voreingestellten Steuercode festlegen. Es sind beide Attribute erforderlich, um die Steuern für ein verbundenes Konto zu berechnen.

Komponente für Steuerregistrierungen

Mit der Komponente für Steuerregistrierungen können verbundene Konten ihre Steuerregistrierungen verwalten. Wenn ein verbundenes Konto keine Steuerregistrierung hinzufügt, sondern die Steuer für den jeweiligen steuerlichen Zuständigkeitsbereich berechnet, gibt Stripe Tax einen Steuerbetrag von 0.00 zurück und setzt den Grund der Steuerpflicht auf not_collecting.

Ihre Plattform muss dann prüfen, ob verbundene Konten Stripe Tax konfiguriert haben, um Steuerberechnungen zu aktivieren.

Notiz

Melden Sie sich an, um zu prüfen, ob Ihre verbundenen Konten bereit sind, Stripe Tax zu verwenden.

Auf der Seite „Verbundene Konten“ in Ihrem Dashboard können Sie die Liste nach Konten filtern, die bereit sind, Stripe Tax zu verwenden. Sie können diese Konten auch mit den folgenden mit Stripe Tax verknüpften Spalten exportieren:

  • Status der Steuereinstellungen: Der Wert active zeigt an, dass das Konto für die Verwendung von Stripe Tax bereit ist. Der Wert pending gibt an, dass einige Pflichtfelder fehlen.
  • Status des Steuerschwellenwerts: Der Wert exceeded gibt an, dass die berechneten Verkäufe oder Transaktionen des Kontos über dem Schwellenwert des Standorts liegen und das Unternehmen sich wahrscheinlich steuerlich registrieren muss. Weitere Informationen finden Sie unter Überwachen Ihrer Verpflichtungen.
  • Steuerregistrierungsstatus Der Wert active zeigt an, dass das Konto mindestens eine aktive Steuerregistrierung hat.

Sie können auch überprüfen, ob ein Konto Stripe Tax konfiguriert hat, indem Sie die Tax Settings API verwenden.

Dem Produktkatalog Steuercodes zuweisen
Optional

Um Steuern zu berechnen, muss Stripe Tax die verkauften Produkte in die entsprechenden Steuercodes einordnen. Eine Möglichkeit besteht darin, einen voreingestellten Steuercode für jedes verbundene Konto anzugeben. Dies ist wahrscheinlich ausreichend, wenn Ihre verbundenen Konten gewöhnlich nur Artikel aus einer einzigen Kategorie verkaufen.

Wenn Sie Ihren Nutzerinnen und Nutzern jedoch mehr Kontrolle bieten möchten, können Sie ihnen erlauben, Produkten einen Steuercode zuzuordnen. Eine Liste der unterstützten Produktsteuercodes können Sie über die Tax Code API von Stripe abrufen. Sie können auch nur einen Teil der Liste zulassen, wenn Ihre verbundenen Konten nur bestimmte Arten von Produkten verkaufen.

Steuerberechnung und -erhebung integrieren

Sie müssen eine Vernetzung mit Stripe Tax vornehmen, um Steuern im Rahmen Ihres Bezahlvorgangs zu berechnen.

Payment Links

Payment Links für einmalige Zahlungen

Wählen Sie einen der derzeit unterstützten Zahlungstypen, mit denen das verbundene Konto mit Stripe Payment Links steuerpflichtig werden kann:

Für Aufrufe der Payment Links API:

  • Geben Sie den Header Stripe-Account mit dem Wert der verbundenen Konto-ID an.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true

Payment Links für Abonnements

Wählen Sie einen der derzeit unterstützten Zahlungstypen, mit denen das verbundene Konto mit Stripe Payment Links steuerpflichtig werden kann:

Für Aufrufe der Payment Links API:

  • Geben Sie den Header Stripe-Account mit dem Wert der verbundenen Konto-ID an.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true

Checkout

Checkout-Sitzungen für einmalige Zahlungen

Wählen Sie einen der derzeit unterstützten Zahlungstypen, mit denen das verbundene Konto mit Stripe Checkout steuerpflichtig werden kann:

Für Aufrufe der Checkout Sessions API:

  • Geben Sie den Header Stripe-Account mit dem Wert der verbundenen Konto-ID an.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Checkout-Sitzungen für Abonnements

Wählen Sie einen der derzeit unterstützten Zahlungstypen, mit denen das verbundene Konto mit Stripe Checkout steuerpflichtig werden kann:

Für Aufrufe der Checkout Sessions API:

  • Geben Sie den Header Stripe-Account mit dem Wert der verbundenen Konto-ID an.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Billing

Abonnements

Wählen Sie einen der derzeit unterstützten Zahlungstypen, mit denen das verbundene Konto mit Stripe Subscriptions steuerpflichtig werden kann:

Für Aufrufe der Subscriptions API:

  • Geben Sie den Header Stripe-Account mit dem Wert der verbundenen Konto-ID an.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "items[0][quantity]"=1 \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "automatic_tax[enabled]"=true

Invoicing

Wählen Sie einen der derzeit unterstützten Zahlungstypen, mit denen das verbundene Konto mit Stripe Invoicing steuerpflichtig werden kann:

Für Aufrufe der Invoices API:

  • Geben Sie den Header Stripe-Account mit dem Wert der verbundenen Konto-ID an.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "automatic_tax[enabled]"=true

Benutzerdefinierte Abläufe mit der Stripe Tax API

Payment Intents

Wählen Sie einen der derzeit unterstützten Zahlungstypen, mit denen das verbundene Konto mit Stripe Tax API steuerpflichtig werden kann:

Für Aufrufe der Tax Calculation API:

  • Geben Sie den Header Stripe-Account mit dem Wert der verbundenen Konto-ID an.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/tax/calculations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d currency=usd \
  -d "line_items[0][amount]"=1000 \
  -d "line_items[0][reference]"=L1 \
  -d customer=
"{{CUSTOMER_ID}}"

Für Aufrufe der Payment Intents API:

  • Geben Sie den Header Stripe-Account mit dem Wert der verbundenen Konto-ID an.
  • Geben Sie amount mit dem von der Steuerberechnung zurückgegebenen amount_total an.
  • Geben Sie metadata[tax_calculation] mit der von der Steuerberechnung zurückgegebenen id an.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "metadata[tax_calculation]"=
"{{CALCULATION_ID}}"

Sie müssen außerdem Steuertransaktionen erstellen, um die von Ihren Kundinnen/Kunden erhobenen Steuern zu erfassen, und Rückerstattungen zu berücksichtigen.

Zahlungen außerhalb von Stripe

Prüfen Sie, wie Sie die Integration mithilfe der Stripe Tax API durchführen und wie das verbundene Konto steuerpflichtigwerden kann. Geben Sie dafür den Stripe-Account-Header mit dem Wert der verbundenen Konto-ID in den Tax Calculation API-Aufrufen ein:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/tax/calculations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d currency=usd \
  -d "line_items[0][amount]"=1000 \
  -d "line_items[0][reference]"=L1 \
  -d customer=
"{{CUSTOMER_ID}}"

Sie müssen außerdem Steuertransaktionen erstellen, um die von Ihren Kundinnen/Kunden erhobenen Steuern zu erfassen, und Rückerstattungen zu berücksichtigen.

Nach der Implementierung beginnt Stripe automatisch mit dem Einzug der Steuern in den Zuständigkeitsbereichen, in denen der Nutzer/die Nutzerin über eine aktive Registrierung verfügt.

Notiz

Unabhängig von der Integration erhält Ihr verbundenes Konto standardmäßig eine Gutschrift für den eingezogenen Steuerbetrag.

Auf Stripe Tax-Berichte zugreifen

Ihre verbundenen Konten können die Stripe Tax-Berichte verwenden, um ihnen bei der korrekten Einreichung und Abführung der Steuern zu helfen.

Verbundenes Konto, das das Stripe-Dashboard nutzt

Diese Option ist nur für Konten mit Zugriff auf das Stripe-Dashboard verfügbar (zum Beispiel Standard-Konten).

Die verbundenen Konten können über die Funktion Steuerberichterstattung im Stripe-Dashboard auf ihre Stripe Tax-Berichte zugreifen.

Die Stripe-API nutzen

Verwenden Sie diese Option für Konten ohne Zugriff auf das Stripe-Dashboard (z. B. Custom- und Express-Konten).

Plattformen können eine Aufstellung der Steuertransaktionen für ihre verbundenen Konten mithilfe der Report API mit dem Berichtstyp connected_account_tax.transactions.itemized.2 herunterladen.

Wenn eine Plattform den folgenden Befehl ausführt, lädt sie alle 2022-Transaktionen von allen verbundenen Konten herunter:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d report_type="connected_account_tax.transactions.itemized.2" \
  -d "parameters[interval_start]"=1641013200 \
  -d "parameters[interval_end]"=1672549200

Wenn eine Plattform den folgenden Befehl ausführt, lädt sie alle 2022-Transaktionen von einem einzigen verbundenen Konto herunter:

Notiz

Um Berichte für verbundene Konten zu erstellen, verwenden Sie den Parameter connected_account anstelle des Stripe-Account-Headers.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d report_type="connected_account_tax.transactions.itemized.2" \
  -d "parameters[interval_start]"=1641013200 \
  -d "parameters[interval_end]"=1672549200 \
  -d "parameters[connected_account]"={{CONNECTED_ACCOUNT_ID}}

Verwenden Sie die eingebettete Komponente zum Exportieren von Steuertransaktionen

Weitere Informationen zu dieser Komponente und ihrer Integration finden Sie unter Steuertransaktionen exportieren.

Siehe auch

War diese Seite hilfreich?
JaNein