Skip to main content
Skip to main content

Region

A region holds settings specific to a geographical location, including the currency, tax rates, and fulfillment and payment providers. A Region can consist of multiple countries to accomodate common shopping settings across countries.

Properties

automatic_taxesbooleanRequired
Whether taxes should be automated in this region.

Default: true

countriesCountry[]Required
The details of the countries included in this region.
created_atDateRequired
The date with timezone at which the resource was created.
currencyCurrencyRequired
The details of the currency used in the region.
currency_codestringRequired
The three character currency code used in the region.
deleted_atnull | DateRequired
The date with timezone at which the resource was deleted.
fulfillment_providersFulfillmentProvider[]Required
The details of the fulfillment providers that can be used to fulfill items of orders and similar resources in the region.
gift_cards_taxablebooleanRequired
Whether the gift cards are taxable or not in this region.

Default: true

idstringRequired
The region's ID
includes_taxbooleanRequired
Whether the prices for the region include tax

Default: false

metadataRecord<string, unknown>Required
An optional key-value map with additional details
namestringRequired
The name of the region as displayed to the customer. If the Region only has one country it is recommended to write the country name.
payment_providersPaymentProvider[]Required
The details of the payment providers that can be used to process payments in the region.
tax_codestringRequired
The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.
tax_providerTaxProviderRequired
The details of the tax provider used in the region.
tax_provider_idnull | stringRequired
The ID of the tax provider used in this region
tax_ratenumberRequired
The tax rate that should be charged on purchases in the Region.
tax_ratesnull | TaxRate[]Required
The details of the tax rates used in the region, aside from the default rate.
updated_atDateRequired
The date with timezone at which the resource was updated.
Was this section helpful?