Verwenden Sie die Settings API, um Stripe Tax zu konfigurieren

Prüfen Sie, ob Sie für die Nutzung von Stripe Tax bereit sind

Führen Sie diese Prüfung durch, wenn Sie beurteilen möchten, ob Stripe Tax aktiviert werden kann. Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe API. Rufen Sie das tax.settings-Objekt ab:

curl https://api.stripe.com/v1/tax/settings \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Sie können auch das Webhook-Ereignis tax.settings.updated überwachen, das ausgelöst wird, wenn Sie Steuereinstellungen über das Stripe Dashboard aktualisieren oder wenn neue erforderliche Steuereinstellungen eingeführt werden. Unter Live-Einsatz von Webhooks erfahren Sie, wie Sie einen Webhook-Endpoint hinzufügen.

Sie können 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": {}
  }
}

Sie können 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 konfigurieren

Führen Sie diesen Schritt aus, wenn Sie die gesamte Stripe Tax-Konfiguration über Ihre eigene Schnittstelle verwalten.

Sie können die Einstellungen ü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.

curl https://api.stripe.com/v1/tax/settings \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "defaults[tax_code]"=txcd_10000000 \
  -d "defaults[tax_behavior]"=inclusive \
  -d "head_office[address][country]"=DE

Das aktualisierte tax.settings-Objekt verfügt jetzt über eine Hauptverwaltung, einen voreingestellten Steuercode und ein Standardsteuerverhalten, sodass Sie Stripe Tax 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.

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