Step 1
Start inside Fortuna with the exact store domain
Open Shopify Setup in Fortuna and enter the exact *.myshopify.com domain you are connecting before you open Shopify Apps or Dev Dashboard.
Shopify BYO Setup
Connect your Shopify store without starting over.
Use Fortuna Setup for the real connection flow. This page is the backup reference if you need to confirm the exact Shopify app values or the final Shopify account-link step.
Best path Continue inside Fortuna Setup
Use this page when You are blocked, confused, or validating credentials
Enter the store domain
Paste the exact
*.myshopify.com domain for the store you are connecting.
Paste the app credentials
Paste the
Client ID and Client Secret from the Shopify app installed on that same store.
Click Connect store and finish in Shopify
Click
Connect store here, then finish the final Shopify step. Shopify either links immediately or asks for the account email before setup continues.
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.
Step 2
Create the app in Dev Dashboard with these exact values
Use the Setup card actions to open Shopify Apps, then move into Dev Dashboard and create 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 3
Install the app, paste the credentials into Fortuna, and connect the store
After the app is created and installed, copy the Client ID and Client Secret from that app’s settings, paste them into Fortuna, and click Connect store. Keep the Shopify tab open because the last part of setup finishes there.
Step 4
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.