Shipping - International Enhancements for Multi-Storefront

When you sell internationally or to multiple customer segments, you may want the available shipping methods for a shipping zone to depend on the shopper's region or segment.

To localize your storefront, you can have zones that display different methods depending on the storefront channel. When you create a method for a zone, specify which storefront channel(s) you want a shipping method to appear. Shoppers will only see the shipping method for the zone if it applies to a channel.

Limitations

You can't assign the following to a specific channel:

• The free shipping method on static shipping quotes (opens in a new tab).
• Pickup methods on stores using Buy Online Pickup in Store.

We don't support multiple accounts of the same carrier (e.g., using distinct accounts for UPS).

Settings

Shipping methods have a channel_ids setting. This setting determines which channels can display the shipping zone's method. Shipping methods are available on all channels by default.

For reference, see the Shipping method endpoint of the REST Management API.

Example

The following example creates a shipping method in a zone by sending a request to the Create a shipping method endpoint.

POST https://api.bigcommerce.com/stores/{{store_hash}}/v2/shipping/zones/{{zone_id}}/methods
X-Auth-Token: {{ACCESS_TOKEN}}
Accept: application/json
Content-Type: application/json
 
{
  "name": "Per Order",
  "type": "perorder",
  "settings": {
    "rate": 8
  },
  "enabled": true,
  "handling_fees": {
    "fixed_surcharge": "3"
  },
  "channel_ids": [1, 3]
}

Additional resources

• Introduction to Multi-Storefront
• Shipping methods endpoint reference