# Supporting Franchise Merchants in a White-Labeled App (Multi-Merchant / Multi-Location Setup) **URL:** \ **Category:** Questions\ **Tags:** orders-api, locations-api, merchants-api\ **Created:** [August 12, 2025, 4:08pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649 "2025-08-12T16:08:22Z")\ **Posts on this page:** 9\ **Page:** 1
**Author:** ![balmonte](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/balmonte/32/2256_2.png) [@balmonte](https://developer.squareup.com/forums/u/balmonte)\ **Post date:** [August 12, 2025, 4:08pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/1 "2025-08-12T16:08:23Z")
We have a potential customer interested in our white-labeled app who operates a franchise business using Square. Each franchise location is set up under its own Square merchant account (not just multiple locations under a single merchant). Today, our app supports individual merchants and merchants with multiple locations under a single account via the Locations API and OAuth. My questions are: 1. Is there any Square documentation or best practices for supporting franchise structures where each location operates as a separate merchant account? 2. For our use case, would each franchise location require its own OAuth connection, or is there a way to centralize/manage access across multiple merchant accounts? 3. Are there any special considerations in APIs, permissions, or data models when working with franchise setups compared to standard multi-location merchants? Any guidance or official resources would be greatly appreciated so we can scope the changes needed to support this customer and other franchise operators. ---
**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\ **Post date:** [August 12, 2025, 4:08pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/2 "2025-08-12T16:08:54Z")
👋 I’m Square Dev AI, here to help answer your question! Based on the information you’ve provided, the following documentation will help answer your question: > **[Merchant APIs](https://developer.squareup.com/docs/merchant-details)** > > Use Square merchant APIs to configure and access account details that support merchant services across many locations. > **[App Marketplace Frequently Asked Questions](https://developer.squareup.com/docs/app-marketplace/faq)** > > Get answers to frequently asked Developer App Marketplace questions. > **Additional Documentation** > > [Merchants API](https://developer.squareup.com/docs/merchants-api) > [Locations API](https://developer.squareup.com/docs/locations-api) > [International Development](https://developer.squareup.com/docs/international-development) If this documentation helped you find a solution, please check the box indicating that this reply solves the problem. Otherwise one of our Developer Advocates will provide additional assistance shortly. ---
**Author:** ![Bryan-Square](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/bryan-square/32/38_2.png) [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\ **Post date:** [August 12, 2025, 7:57pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/3 "2025-08-12T19:57:52Z")
For this model yes, OAuth would be the recommended approach. As for permissions you’ll want to get the set of permissions that your app needs to operate as expected. 🙂 ---
**Author:** ![balmonte](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/balmonte/32/2256_2.png) [@balmonte](https://developer.squareup.com/forums/u/balmonte)\ **Post date:** [August 12, 2025, 9:21pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/4 "2025-08-12T21:21:30Z")
Hi @Bryan-Square I’m sorry but I am not getting much clarity from your response. Is there a flow chart or additional documentation that can be shared for how the Square Franchise works? Without any knowledge of the expected flow its hard to understand how to proceed. From your response however, are you saying that we would need to request Oauth authorization for each franchisee to access their specific location info? That will not be available from the main Franchisor? Apologies but just trying to understand how this all works. ---
**Author:** ![Bryan-Square](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/bryan-square/32/38_2.png) [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\ **Post date:** [August 12, 2025, 9:46pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/5 "2025-08-12T21:46:20Z")
Are you using the our internal Franchise API? 🙂 ---
**Author:** ![balmonte](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/balmonte/32/2256_2.png) [@balmonte](https://developer.squareup.com/forums/u/balmonte)\ **Post date:** [August 12, 2025, 10:06pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/6 "2025-08-12T22:06:12Z")
No, I didn’t know there was one. How do I get access to that on my developer profile? I don’t see it in the list of Square APIs. That would be a great start. ---
**Author:** ![Bryan-Square](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/bryan-square/32/38_2.png) [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\ **Post date:** [August 12, 2025, 10:49pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/7 "2025-08-12T22:49:34Z")
I’m not sure the team is really onboarding to that. As for connecting to a franchise where each account is a unique Square account you use OAuth to connect to each account. Then your app will need to route each API request to the correct account. 🙂 ---
**Author:** ![balmonte](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/balmonte/32/2256_2.png) [@balmonte](https://developer.squareup.com/forums/u/balmonte)\ **Post date:** [August 12, 2025, 11:08pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/8 "2025-08-12T23:08:08Z")
I would love to be onboarded if possible so that I can support this business with their need on our white labeled solution with Gegsy. If it helps, I’m also a Square Champion in the seller community, and a Square merchant with two locations. It would really help us get Gegsy to that next level if we could differentiate ourselves by supporting franchise merchants. How can I put in a request so that I can develop towards this now without workarounds? Thanks again for your help. ---
**Author:** ![balmonte](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/balmonte/32/2256_2.png) [@balmonte](https://developer.squareup.com/forums/u/balmonte)\ **Post date:** [August 14, 2025, 6:54pm UTC](https://developer.squareup.com/forums/t/supporting-franchise-merchants-in-a-white-labeled-app-multi-merchant-multi-location-setup/23649/9 "2025-08-14T18:54:58Z")
@Bryan-Square wanted to bump up my last message. Hoping there is a way I can get access to the Franchise API. Is there a request from or anyone specific I would need to request this from? Thanks again