Decoding Shopify App Review: How to Prove Your Free Connector App Isn't an 'External Billing Gateway'

Hey store owners and fellow developers!

If you’ve ever submitted an app to the Shopify App Store, you know the review process can sometimes feel like navigating a maze blindfolded. Policies are strict, and misunderstandings can lead to frustrating rejections. I recently caught an interesting discussion in the Shopify community that really shed some light on a common headache: getting a free connector app approved when your core SaaS platform has its own external billing.

The “External Billing” Conundrum for Free Connector Apps

Our community member, webriy, brought up a classic scenario. They built BrandKity: Brand Asset Manager, a Shopify embedded admin app. Its job is simple: connect a merchant’s existing BrandKity account via an API key, let them browse assets, and import selected ones into Shopify Files. Crucially, this app is read-only for BrandKity, doesn’t create or edit kits, and doesn’t write data back to BrandKity. The Shopify connector feature itself is free for all BrandKity users, even those on their Free plan. Merchants aren’t required to upgrade any paid BrandKity tier to use the Shopify integration.

Sounds straightforward, right? Well, the Shopify App Review team kept rejecting it for “external billing.” They provided a screencast showing BrandKity’s external dashboard > billing page and an “Upgrade” button opening a LemonSqueezy checkout. The problem? This screencast didn’t show how to get to that billing page from within the Shopify embedded app. It simply demonstrated that BrandKity, as a standalone SaaS, has a billing page. webriy was understandably frustrated, asking repeatedly for Shopify to “show the exact in-app entry point” to this alleged billing flow, but received no clear answers.

Navigating the “Gateway App” Perception

Another community member, DougInOr, initially chimed in with a perspective that many developers might encounter — the idea that simply having an external billing flow, even if not directly linked in the app, could be a violation. Doug suggested that Shopify might see such apps as “gateway apps” — a front for another billing system. This highlights a common assumption reviewers might make: if your associated SaaS has paid tiers, the app must be funneling users there for billing.

This is where the distinction becomes critical. Shopify’s policy states that “App Store apps that charge merchants should use Shopify-managed billing.” The key word here is “charge merchants” through the app. If your app is truly just a connector, and the billing for your core SaaS happens entirely externally without any prompts or links within the Shopify app, then it shouldn’t technically violate this rule.

The Breakthrough: Shopify’s Acknowledgment

Thankfully, webriy’s persistence paid off! In a crucial update, webriy shared that Shopify had re-reviewed the screencast and acknowledged that their evidence did not show a billing flow originating from the embedded app. Shopify’s latest support email explicitly stated the video “solely displays your external BrandKity dashboard” and “does not depict a merchant navigating from the Shopify embedded app to that billing page.” This was a huge win, confirming that the existence of external SaaS billing isn’t the issue, but rather the in-app linking to it.

How to Prove There’s No In-App Billing: Actionable Steps

This community discussion, especially lumine’s excellent advice, provides a clear roadmap for how to proactively tackle “external billing” flags, even if your app is truly free and compliant. It’s all about making your case crystal clear to the reviewers.

1. Front-Load Your Screencasts with “Negative-Space Proof”

Don’t just show what your app does; explicitly show what it doesn’t do. Reviewers are often looking for specific “red flags” and process videos quickly. Make it impossible for them to miss the absence of billing elements.

• Open the embedded app: Start your screencast directly inside the Shopify admin, with your app loaded.
• Walk through every page: Systematically navigate to every single view and tab within your embedded app.
• Hover every CTA: Explicitly hover your mouse over every button, link, and call-to-action (CTA) to show its destination.
• Add clear captions: Use text overlays or voiceover to state things like “no upgrade prompt here,” “this opens Shopify Files modal, no external navigation,” or “no billing section visible.”
• End on the merchant landing page: Show the full journey and make it clear there are no hidden paths.

2. Address API Key Fields Proactively

If your app requires an API key for connection to an external service (like BrandKity did), reviewers might assume this field implies a billing setup step. Show the connection succeeding without any plan-tier interaction:

• Demonstrate entering the API key.
• Show the successful connection.
• Explicitly state or caption that “this API key is available on all BrandKity plans, including the Free plan, and does not require an upgrade.”

3. Document Your App’s Billing Compliance

While not explicitly mentioned as a solution in the thread, having a clear explanation of your app’s billing model in your submission notes or developer documentation can save a lot of back-and-forth. Clearly state:

• That the Shopify app itself is free.
• That it does not contain any links or prompts to external billing.
• That any associated external SaaS billing is entirely separate and not gated by the Shopify integration.

Dealing with “No-Reply” Review Emails

webriy also highlighted a frustrating communication issue: being told to “reply directly to the rejection email” only to find it came from a no-reply address. This is a common pain point. If you encounter this, ensure you open a support ticket with Shopify Developer Support and reference your app submission ID. Clearly explain that you cannot reply to the review email and need their assistance to communicate with the App Review Team.

The key takeaway from webriy’s journey and lumine’s advice is that persistence and extremely clear, proactive demonstration are your best friends in the Shopify App Review process. Even when facing initial misunderstandings, providing unambiguous “negative-space proof” in your screencasts can help reviewers quickly grasp that your app is compliant. It might take a few tries, but with solid evidence, you can get your free connector app approved!