Sample - Stripe API
POST/v1/tax/settings

Update settings

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

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

3 body fields
defaultsobjectoptional
Default configuration to be used on Stripe Tax calculations.
expandarray<string>optional
Specifies which fields in the response should be expanded.
head_officeobjectoptional
The place where your business is located.

2 status codes
200Successful response.
defaultsobjectrequired
head_officeobjectoptional
The place where your business is located.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:tax.settings
statusstringrequired
The status of the Tax `Settings`.
Allowed:activepending
status_detailsobjectrequired
defaultError response.
errorobjectrequired

Error handling

Any other status is an error: Error response.