Customization in Shopify UI - how much?

Shopify App Store
1

Hello,

The Shopify app reviewers asked me to allow for client invoice customization within the Shopify UI because it’s available in Qonto. My app allows to connect a Qonto account to Shopify to turn paid orders into Qonto invoices. I want to make sure that if I only allow for what’s already available via API in Qonto within the Shopify UI, and if I redirect to Qonto via a deeplink for the rest, it’d be ok.

What do you guys think?

Thanks,

----------

Client invoice customization :

  • Strategy: expose customization settings directly in the Shopify app for all fields supported by the API. For settings that have no API equivalent, provide a “Customize in Qonto” deeplink pointing to the Invoicing Settings page in the Qonto app.

  • :white_check_mark: Available in the Shopify app (via API)

    These fields will be configurable in the Shopify app’s Settings screen, stored as defaults, and passed via the settings object (or top-level fields) on each invoice creation.

image.png

  • :link: Deeplink to Qonto (no API equivalent)

    These settings have no API support and require the Qonto platform UI. The Shopify app will show a “Customize in Qonto ->” button linking to the Invoicing Settings page for these.

image.png

2

Hey @plc - thanks for reaching out.

I can’t guarantee the exact review outcome here, but your proposed approach sounds like the right direction: anything that can be configured through Qonto’s API and affects how Shopify orders become Qonto invoices should be available directly in the embedded Shopify app.

For the fields that genuinely have no Qonto API equivalent, linking out to the relevant Qonto settings page makes sense as long as the embedded Shopify app still gives merchants a useful configuration experience on its own. I’d also recommend making this really clear in your App Review notes, something along the lines of:

  1. These invoice customization fields are available via Qonto API and are configurable directly in the Shopify app.
  2. These additional fields are only configurable in Qonto because Qonto does not expose API support for them.
  3. The Shopify app provides a direct link to the relevant Qonto settings page for those Qonto-only settings.

The main thing reviewers will likely look for is whether the Shopify-specific workflow can be set up and managed from Shopify Admin, rather than the app acting mostly as a redirect to Qonto. So exposing the supported invoice defaults, connection status, sync/invoice activity, and any relevant error states inside the embedded app would be the strongest version of this.

Let me know if I can clarify anything on our end here!

3

Hey Alan, thanks for this - makes sense!

4

No worries - I’ll close our thread for now, but feel free to ping me if I can help out further!