If your Terminal deployment uses many readers across multiple physical locations, keeping track of them all can get overwhelming. Locations help you manage readers and their activity by associating them with a physical operating site. They also ensure your readers download the proper regional configurations.
Use the Terminal Locations object to group readers, view their connectivity status, and customize their settings by physical location. This can be especially helpful for marketplaces with many connected accounts.
Creating a location Server-side Dashboard
Create a Location for each physical location that your readers operate at. If your business requires you to move your readers frequently, your locations may use addresses that represent a primary place of business.
To create a new location using the API, use the create location request.
Creating a location with Standard Connect
In order to create a location for a Standard Connect Account, use the
Stripe-Account header in your request. These locations are only accessible by the Connect account you authenticate as. You can create multiple locations for any individual Standard Connect account, if the merchant operates in multiple physical sites.
Creating a location with Custom Connect
For Custom Connect integrations, locations belong to the platform account and are not mapped strictly to Connect accounts. If your platform needs to associate Custom Connect accounts with locations, you can store a reference to the relevant account(s) in the location’s metadata property.
You can also create locations from the Stripe Dashboard, under Locations.
When you register your reader to a location, the specified location groups the reader and defines its country settings. If you don’t provide a location, the reader will be ungrouped on your account and default to the regional configuration associated with the country of your Stripe account.
When you connect to a BBPOS Chipper 2X BT for the first time, it will be automatically registered and will be ungrouped on your account. The BBPOS Chipper 2X BT can only be used in the United States.