Shopify BYO Setup

Connect your Shopify store without starting over.

Use this page as the Shopify connection guide when you need the exact app values, install order, and final workspace-link step in one place. Keep one store and one app identity all the way through the flow.

Best path Use one store and one app, then connect with the matching credentials

Use this page when You are blocked, confused, or validating credentials

Jump to exact app values Open Billing Get support

Enter the store domain Paste the exact *.myshopify.com domain for the store you are connecting.

Copy the app credentials Use the Client ID and Client Secret from the same Shopify app installed on the same store.

Paste the app credentials and connect the store Use the store domain plus the matching Client ID and Client Secret from that same app, then click Connect store.

Most connection failures come from mixing stores or apps. If the domain, app, or credentials came from different Shopify flows, stop and fix that first. Do not keep retrying the final connect step with mismatched values.

Important: Fortuna expects one store and one app on this page. Use the exact *.myshopify.com domain, then use the Client ID and Client Secret from the same installed Shopify app on that same store.

Step 1

Start with the exact store domain

Choose the exact *.myshopify.com domain you are connecting before you open Shopify Apps or Dev Dashboard. Keep that same store identity through the rest of the flow.

Step 2

Open the same Shopify app and copy the app credentials

Open the Shopify app that belongs to the exact *.myshopify.com domain you entered in Fortuna. Copy the Client ID and Client Secret from that same app's credentials page.

Use one store and one app. If the app is not installed yet, install it on that same store first, then copy the credential pair you plan to use in Fortuna.

Step 3

If the app is not ready yet, create or inspect it with these exact values

Open Shopify Apps, then move into Dev Dashboard and create or inspect the app that will be installed on that exact store. When Shopify shows the create-version form, fill it out like this:

App name

Fortuna App

Use this name so the setup guide, screenshots, and support references stay aligned.

App URL

https://api.hirefortuna.com

This should point at Fortuna's production API host.

Embed app in Shopify admin

On

Fortuna expects the app to remain embedded.

Preferences URL

https://api.hirefortuna.com/shopify/app

Set this so Shopify returns to Fortuna's embedded app page after install.

Webhooks API Version

2025-04

If Shopify fills a newer default, change it back to this version.

Required scopes

read_products,read_orders,write_orders,read_customers

Enter this exact comma-separated list with no spaces. Fortuna uses customer records in the web app so agents know which customer a ticket or order belongs to.

Optional scopes

Leave blank

Do not add extra optional scopes for this setup.

Use legacy install flow

Off

Leave this disabled.

Redirect URLs

https://api.hirefortuna.com/api/v1/shopify/app/callback

Enter only this callback URL.

POS / App proxy

Leave blank

Fortuna does not need POS or app proxy settings for this connection.

After you save the version, release it and install that same app on that same store before returning to Fortuna.

Step 4

Install the app, copy the app credentials, and connect the store

After the app is created and installed, copy the Client ID and Client Secret on that app’s credentials page, paste the matching credentials into the Shopify connection form in your Fortuna merchant workspace, and click Connect store. Keep the Shopify tab open because the first sync starts immediately after connect.

Step 5

Finish the workspace link in Shopify

After Connect store, Shopify opens the embedded Fortuna setup step. If Fortuna can already match this install to your checkout session or one existing Shopify Fortuna account, it links immediately and setup keeps moving. If not, enter the email for the existing Fortuna workspace you want to link, or create a new workspace there, then click Send verification email.

Best case: immediate link. Fallback: email confirmation. If Shopify asks for the email, open the verification email and keep the Shopify tab open. After you confirm the email link, the Shopify setup page refreshes automatically. If you also want to open the merchant account, open it in a new tab so you do not lose your place in Shopify.