The Locations API is designed to help merchants manage multiple points of sale, including both online storefronts and physical stores. Registering locations lets you differentiate and group your orders from different stores. You can also introduce custom business logic for each location, such as different inventory management, pricing, or shipping rules.
To start using locations, follow the relevant use case for your business:
type
to online
.location_id
parameter in the request body during order creation to assign the order to a specific location.type
to physical
.location_id
to associate the order with your location.Locations are particularly useful for tailoring the user experience on each of your online storefronts, especially when using features like Fast checkout.
For example, if you operate two online stores with different shipping rules, you can register two separate online
locations. By then using the location_id
to register a distinct address validation endpoint for each one, your backend can apply the correct shipping logic and pricing for the specific storefront a customer is buying from.