During authorization, the ID I get back is a merchantId. Does this merchant-level authorization therefore give me the ability to create orders for, and pull the product listings of, all the stores under that merchant? (The required permissions were requested at authorization time.)
Yes.
OAuth authorization in Square is merchant-level, so the access token covers every location (store) under that merchant account. No separate authorization is needed per location.
- Orders: call ListLocations to get the location IDs, then pass the target
location_idin each CreateOrder request. - Products: the catalog belongs to the merchant, not to a single location. SearchCatalogObjects or ListCatalog returns all items. Use
present_at_all_locations,present_at_location_idsandabsent_at_location_idson each object to work out which items are sold at which location.
This only applies to locations inside the same merchant account. If the seller runs stores under separate Square accounts, each account has its own merchant_id and needs its own authorization and token.
Let me know if that helps!