Verwenden Sie die Settings API, um Stripe Tax zu konfigurieren

Erfahren Sie, wie Sie die Steuereinstellungen konfigurieren und prüfen, ob ein Konto für die Steuerberechnung bereit ist.

Mit der Stripe Tax Settings API können Sie die für die Steuerberechnung erforderlichen Einstellungen abrufen und konfigurieren, ohne sich auf das Stripe Dashboard zu verlassen.

Connect-Plattform: Als Plattform können Sie diese API verwenden, um Ihre verbundenen Konten für die Verwendung von Stripe Tax einzurichten oder um zu überprüfen, ob ein Konto bereits entsprechend eingerichtet ist.
Direkte Nutzung: Sie können diese API verwenden, um Stripe Tax einzurichten oder um zu überprüfen, ob Sie bereits entsprechend eingerichtet sind.

Prüfen Sie, ob das verbundene Konto für Stripe Tax bereit ist

Füllen Sie diese Prüfung aus, wenn das Standard-Konto Stripe Tax über das Stripe-Dashboard konfiguriert, Ihre Plattform jedoch prüfen muss, ob Stripe Tax aktiviert werden kann.

Verwenden Sie unsere offiziellen Bibliotheken, um von Ihrer Anwendung aus auf die Stripe-API zuzugreifen. Um die Einstellungen von Stripe Tax für das verbundene Konto zu überprüfen, rufen Sie das tax.settings-Objekt ab. Hierfür verwenden Sie den Stripe-Account-Header und übergeben den Wert der verbundenen Konto-ID.

Sie können auch das Webhook-Ereignis tax.settings.updated überwachen, das ausgelöst wird, wenn Konten ihre Steuereinstellungen aktualisieren oder wenn neue erforderliche Steuereinstellungen eingeführt werden. Unter Live-Einsatz von Webhooks erfahren Sie, wie Sie einen Webhook-Endpoint hinzufügen. Wählen Sie außerdem unbedingt im Dashboard die Option Überwachen Sie Ereignisse von verbundenen Konten aus.

Ein Konto kann Stripe Tax verwenden, wenn das von der API oder dem Webhook-Ereignis abgerufene tax.settings-Objekt für status "active" zurückgibt. Die Einstellungen defaults.tax_code und defaults.tax_behavior sind nur erforderlich, wenn sie nicht bei jedem API-Aufruf im Produkt oder Preis angegeben werden.

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": null,
    "tax_behavior": null
  },
  "head_office": {
    "address": {
      "country": "DE"
    }
  },
  "livemode": false,
  "status": "active",
  "status_details": {
    "active": {}
  }
}

Ein Konto kann Stripe Tax nicht verwenden, wenn das tax.settings-Objekt der Antwort "pending" für den status zurückgibt. Das Objekt status_details[pending][missing_fields] verfügt über eine Liste aller erforderlichen fehlenden Felder.

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": null,
    "tax_behavior": null
  },
  "head_office": null,
  "livemode": false,
  "status": "pending",
  "status_details": {
    "pending": {
      "missing_fields": ["head_office"]
    }
  }
}

Einstellungen für verbundene Konten konfigurieren

Führen Sie diesen Schritt aus, wenn Sie die gesamte Stripe Tax-Konfiguration über eine Schnittstelle auf Ihrer Plattform verwalten.

Sie können die Einstellungen des verbundenen Kontos über einen Aufruf zum Aktualisieren der Einstellungen ändern. Führen Sie einen Aufruf durch und geben Sie dabei den Hauptsitz, den voreingestellten Steuercode und das Steuerverhalten an. Hierfür verwenden Sie den Stripe-Account-Header und übergeben den Wert der verbundenen Konto-ID.

Das aktualisierte tax.settings-Objekt verfügt jetzt über eine Hauptverwaltung, einen voreingestellten Steuercode und ein Standardsteuerverhalten, sodass Sie Stripe Tax für dieses verbundene Konto aktivieren können.

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": "txcd_10000000",
    "tax_behavior": "inclusive"
  },
  "head_office": {
    "address": {
      "country": "DE"
    }
  },
  "livemode": false,
  "status": "active",
  "status_details": {
    "active": {}
  }
}

Validierungen und Fehler

Die Steuercodes müssen sich auf verfügbare Steuercodes beziehen und das Steuerverhalten muss auf inclusive, exclusive oder inferred_by_currency festgelegt werden (nachdem es festgelegt wurde, kann es nicht mehr auf null gesetzt werden). head_office muss eine unterstützte Adresse enthalten.

Die head_office[address] besteht aus den Feldern line1, line2, city, state, postal_code und country. In den folgenden Tabellen werden die unterstützten Adressformate beschrieben.

Beispieladressen	Erklärung	Unterstützt
`line1`: 27 Fredrick Ave `city`: Brothers `state`: OR `postal_code`: 97712 `country`: USA	Vollständige Adresse A full address includes at least a line1 (street address or PO Box), city, state, postal code, and country. Die Adresse wird mit der nächstgelegenen Adresse oder Straße in der Adressdatenbank der US-Post abgeglichen. Wenn keine Übereinstimmung gefunden wird, verwenden wir den geografischen Mittelpunkt (durchschnittlicher Standort der Adressen) der 5-stelligen Postleitzahl als Ausweichlösung.
9-stellige Postleitzahl: `postal_code`: 97712-4918 `country`: USA 5-stellige Postleitzahl: `postal_code`: 97712 `country`: USA	Land und Postleitzahl Wenn Sie eine 5- oder 9-stellige Postleitzahl angeben, verwendet unser System nur die ersten 5 Ziffern für die Steuerberechnung. Die Steuer wird am geografischen Mittelpunkt berechnet, der den durchschnittlichen Standort der Adressen innerhalb des 5-stelligen Postleitzahlenbereichs widerspiegelt. Prüfen Sie, ob dies für Ihr Unternehmen geeignet ist.
`state`: OR `country`: USA	Land und Bundesstaat Wir können keine Steuern für US-Kunden berechnen, die nur einen ISO-Ländercode und einen „State-Code“ haben.
`country`: USA	Land Wir können keine Steuern für US-Kunden berechnen, die nur einen ISO-Ländercode haben.

Verwenden Sie eines der obigen Adressformate, um sicherzustellen, dass wir den Hauptsitz Ihres verbundenen Kontos einheitlich erkennen können. Das Länderfeld muss immer ein gültiger ISO-Ländercode sein.

Notiz

Die hier aufgeführten Validierungen und Fehler sind Teil der Einrichtungsphase. Darüber hinaus sehen Sie möglicherweise weitere Fehler, wenn Sie versuchen, die API in Ihrer Stripe-Integration aufzurufen.