Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

Update settings 

Tax
Tax Settings
Update settings

Updates Tax Settings parameters used in tax calculations. All parameters are editable but none can be removed once set.

Parameters

  • defaultsobject

    Default configuration to be used on Stripe Tax calculations.

    • defaults.tax_behaviorenum

      Specifies the default tax behavior to be used when the item’s price has unspecified tax behavior. One of inclusive, exclusive, or inferred_by_currency. Once specified, it cannot be changed back to null.

      Possible enum values
      exclusive
      inclusive
      inferred_by_currency

    • defaults.tax_codestring

      A tax code ID.

  • head_officeobject

    The place where your business is located.

    • head_office.addressobjectRequired

      The location of the business for tax purposes.

      • head_office.address.citystring

        City, district, suburb, town, or village.

      • head_office.address.countrystring

        Two-letter country code (ISO 3166-1 alpha-2).

      • head_office.address.line1string

        Address line 1 (e.g., street, PO Box, or company name).

      • head_office.address.line2string

        Address line 2 (e.g., apartment, suite, unit, or building).

      • head_office.address.postal_codestring

        ZIP or postal code.

      • head_office.address.statestring

        State/province as an ISO 3166-2 subdivision code, without country prefix. Example: “NY” or “TX”.

Returns

A Tax Settings object.

POST /v1/tax/settings
curl https://api.stripe.com/v1/tax/settings \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d "defaults[tax_behavior]"=inclusive \
  -d "defaults[tax_code]"=txcd_10000000 \
  -d "head_office[address][country]"=DE
Response
{
  "object": "tax.settings",
  "defaults": {
    "tax_behavior": "inclusive",
    "tax_code": "txcd_10000000"
  },
  "head_office": {
    "address": {
      "city": null,
      "country": "DE",
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    }
  },
  "livemode": false,
  "status": "active",
  "status_details": {
    "active": {}
  }
}