Tax Settings

You can use Tax Settings to manage configurations used by Stripe Tax calculations.

Related guide: Using the Settings API

Was this section helpful? Yes No

Update settings

POST / v1 / tax / settings

Retrieve settings

GET / v1 / tax / settings

The Tax Setting object

Attributes

• object string, value is "tax.settings" String representing the object’s type. Objects of the same type share the same value.
• defaults object Default configuration to be used on Stripe Tax calculations.
• head _ office nullable object The place where your business is located.
• livemode boolean If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.
• status enum The status of the Tax Settings. Possible enum values active Tax Settings have the required information and ready for tax calculations. pending Tax Settings missing some required information and not ready for tax calculations. Check status_details field for more.
• status _ details object Information about the status.

The Tax Setting object

{ "object": "tax.settings", "defaults": { "tax_behavior": null, "tax_code": "txcd_10000000" }, "head_office": { "address": { "city": null, "country": "US", "line1": null, "line2": null, "postal_code": null, "state": "CA" } }, "livemode": false, "status": "active", "status_details": { "active": {} }}

Update settings

POST / v1 / tax / settings

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

Parameters

• defaults object Default configuration to be used on Stripe Tax calculations.
• head _ office object The place where your business is located.

Returns

A Tax Settings object.

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": {} }}