Brandbrand
Book a call
A phone on a wooden table with the Shopify logo on its screen

Tinx Customer Portal is in the Shopify App Store, after one review round

Since 11 November, Tinx Customer Portal, the app we built for Tinx-IT, has been in the Shopify App Store. How we took it from first version to listing, and the one point on which the review sent it back.

What the app does

Tinx Customer Portal connects a Shopify store's customer accounts to Microsoft Dynamics 365 Business Central.

A business customer signs in to the store and sees their own orders, invoices, shipments, returns, credit memos and quotes there, live from Business Central. They download the PDF and reorder from an earlier document. No more emailing or calling.

The merchant chooses which sections, fields and labels the customer sees, and can add their own API pages from Business Central. The app works in English, Dutch, German and French, and is free. The merchant does need Business Central with the Tinx-IT extension.

What the customer account and the admin look like is in the case study.

One store or the App Store

An app for one store is installed with a link, without a review. In September we chose the App Store together with Tinx-IT: every merchant on Business Central should be able to install the portal themselves.

You make that choice at Shopify once, and it decides how you build. There is no single store to configure any more. Every merchant enters their own Business Central connection in the app, and its secret is stored encrypted.

The app reads customer data, so Shopify has to approve that access too. That does not happen separately, but together with the review of the listing. We built the app in Laravel, like all our Shopify apps.

What we prepared for the reviewer

A Shopify reviewer installs the app on a test store of their own and tries every feature. That has to work without them needing to ask us anything. So we prepared this:

  • Seven images of 1600 by 900. Without a fake browser bar, because Shopify rejects images that show a browser window, and no two that look too much alike.
  • A screencast in English. From installation to every feature, step by step.
  • A test environment. A Business Central sandbox with a test customer, so the reviewer sees real documents.
  • A self-review up front. Shopify has an AI check that holds the app against the App Store requirements. It gave 30 points green, no failures and one point to look at.

Tinx-IT did the App Store registration and the emergency contact themselves. It is their app and their statement, and the registration asks for the organisation's payment method.

Where it got stuck before submitting

On 12 October everything was ready. Still, the submit button stayed grey. Two automated checks would not turn green: whether the app loads Shopify's App Bridge, and whether it signs in with session tokens. Both were right in the code.

Shopify reads those checks from telemetry the admin sends back to Shopify. From our own Chrome it never arrived, because something on the Mac blocked it. After a session in Safari the checks still stayed open. After we contacted Partner Support they turned green a few days later, and we could submit.

The screen never says that the telemetry is missing. If the checks hang while your code is right, first check whether that data arrives, and bring in Partner Support early.

From choice to App Store

  1. September: we choose the App Store. Every merchant installs the app themselves and connects their own Business Central.
  2. 12 October: listing, screencast and test environment are ready. Two automated checks still keep the button shut.
  3. After we contact Partner Support the checks turn green and we submit.
  4. 29 October: the review pauses on one point. On 31 October we submit again.
  5. 11 November: Tinx Customer Portal is in the App Store.

The one round back

On 29 October the review came back. The reviewer had signed in to the store as a test customer of their own. That customer had no Business Central customer number, so the portal did not know which documents belonged to them. They saw "Information unavailable" and a menu with only Orders and Profile.

To Shopify that is an extension that is not complete (requirement 5.6.1), and the submission was paused until 31 October. Our logs showed no error at all. The app did exactly what it should do for a customer without a link, the reviewer just did not know that.

We fixed it in two places:

  • In the app. The Quick Start got a step in which the merchant links a customer to their customer number.
  • In the testing instructions. Linking their own test customer became a required step before the reviewer signs in. The field takes at most 2,800 characters, ours came to 2,753.

On 31 October we submitted again. On 11 November the app was in the App Store.

Our position

We only submit an app once it works for someone who has never seen it.
Remco, CTO at Brandbrand

What this means for you

If you want your own app in the App Store, count on more than the build. For this app there was a month between ready to submit and live. The review itself was one round.

  • Test as a stranger. The reviewer does not know your data and has no customer that is already linked. What the screen shows then is what they judge.
  • Your testing instructions are part of the app. Write them as a step-by-step plan, with every step the reviewer needs before they see anything.
  • Choose the route up front. One store or the App Store is a choice you cannot undo at Shopify, and it decides how you build.

We do it from start to finish: building the app, making the listing and the screencast, and guiding the review until the app is live. Read more about custom Shopify apps, or see what a custom app costs. You will find the portal itself in the App Store.