Connect Shopify
Create an app in your Shopify account, paste its keys in Fuul, and your store's paid orders become sales.
Fuul reads your Shopify store's paid orders through an app you create in your own Shopify account. Nobody at Fuul needs to do anything for you, and there's nothing to install from the Shopify App Store.
You need:
- An owner or admin role in Fuul.
- Access to the Shopify account that owns your store. The app must be created in that same account.
- A store that sells in US dollars.
1. Create the app in Shopify
-
Open the Dev Dashboard of the Shopify account that owns your store.
-
Choose Apps → Create app, and name it Fuul.
-
Paste these two values, which Fuul's connect dialog also shows with a copy button:
Field Value App URL https://app.withfuul.comScopes read_orders,read_customers,write_discounts -
Untick Embed app.
-
Choose Create app, then Release.
| Scope | Why Fuul needs it |
|---|---|
read_orders | To read each paid order as a sale |
read_customers | To know who the customer is |
write_discounts | To create a discount in your store for each referral code, if you turn that on |
You don't set up any webhooks. Fuul subscribes to the ones it needs when you connect: paid orders (orders/paid) and the app being uninstalled (app/uninstalled).
2. Install it on your store
In the app's overview, under Installs, pick your store and accept. Shopify warns that the app isn't reviewed. That's expected for an app of your own.
3. Paste its keys in Fuul
-
In Fuul, open Settings → Conversion sources and choose Connect a source, then Shopify. During setup, pick Shopify in the Source step.
-
Fill in the three fields:
Field Where to find it Store address Your store's address ending in .myshopify.com. Your Shopify admin shows it in Settings → DomainsClient ID The app's overview, under Credentials Client secret The app's overview, under Credentials -
Choose Connect.
Fuul checks the keys with Shopify before it saves them. When it's done, Shopify appears in Conversion sources with your store's address and Counts its paid orders as sales.
Fuul stores the client ID and secret encrypted, and uses them only to talk to your store.
If Shopify refuses the keys
The dialog points to the field to fix:
| Message | What to do |
|---|---|
| Shopify refused these keys. Check that the app is installed on this store and the keys are its own. | Install the app on this store (step 2), and copy the Client ID and Client secret of this app again |
| Shopify only lets an app reach a store of its own account: create the app in this store's Shopify account. | The app was created in another Shopify account. Create it in the account that owns the store |
| There is no Shopify store at this address. | Check the address. Use the .myshopify.com one, not your own domain |
| This store is connected to another organization. | A store can be connected to one Fuul organization only |
| This organization has another Shopify store connected. Disconnect it first. | Your organization has one Shopify store at a time |
Pasting the keys again for the same store replaces them.
What counts as a sale
- A paid order is a sale. One order counts once, however many times Shopify sends it.
- The amount is the order's total: after discounts, with tax and shipping included.
- Test orders are ignored, such as those paid with Shopify's test gateway.
- US dollars only. An order in another currency is ignored.
- $0 is never a sale.
- Refunds, cancellations and order edits change nothing for now. A refunded order keeps its commission.
Like every source, Fuul processes an order only if it arrives while you're on your free trial or plan.
Who the customer is
The customer is their Shopify customer, and also the order's email when it has one. Their next order, with or without a code, goes to the same affiliate. An order with neither a customer nor an email is credited to no one.
How the code reaches Fuul
Fuul reads the referral code from the order's discount codes. It takes the first one that is one of your referral codes, so your own codes, such as WELCOME10, never get in the way.
For the customer to type an affiliate's code at your checkout, it has to exist in your store. Turn on Fuul's discount for Shopify, below, and every referral code becomes a discount in your store.
Your developer can also apply the code with the customer's email before they buy.
Referral codes as Shopify discounts
With Shopify connected, Rewards → your sale reward shows The customer saves in your Shopify store at the end of What it pays.
- Turn it on.
- In Give referred customers a discount, choose % off or Fixed amount (whole US dollars), and how long it lasts on subscriptions: Forever, or Some payments, from 1 to 120.
- Choose Turn on.
Fuul creates one discount per referral code in your store's Discounts, named Referral discount - Fuul · CODE. New codes, yours and your affiliates', are added a moment after they're made.
| How the discount works | |
|---|---|
| Who gets it | Any buyer who types the code |
| What it applies to | The order's products, never shipping |
| Other discounts | It doesn't combine with them |
| One-time orders | Get it once |
| Pausing a code | Deactivates its discount. Shopify lists it as expired |
| Editing the discount | Updates every code's discount, in a few moments |
| Turning it off | Deletes every referral discount from your store |
- It's set apart from the Stripe discount. Each store has its own.
- Max uses and the last day stay in Fuul. A code past its last day or over its limit still gets the discount in your store, but the order pays no one.
- The discount is yours. Only the affiliate is paid, and a percentage reward pays on what the customer paid, after the discount.
Not in Shopify
If your store already has a discount with a code's text, one you made by hand, Fuul doesn't replace it. That code reads Not in Shopify on its affiliate's Codes tab, and the reward page counts how many with a link to the first one.
Delete that discount in Shopify, then choose Retry in Shopify on the code. If Shopify still refuses, the message says why.
Fuul creates, changes and deletes its referral discounts in your store. Manage them from Fuul, not in Shopify.
Disconnecting
- From Fuul: in Settings → Conversion sources, choose Disconnect on Shopify. Then uninstall the app in Shopify too, or its events keep arriving and are refused.
- From Shopify: uninstalling the app disconnects the source in Fuul.
Either way, the orders already received stay, and Fuul's discount for Shopify turns off. Fuul can no longer reach your store, so the referral discounts stay there: delete them in Shopify's Discounts.
To connect again, paste the keys again. The same store keeps its history.
Good to know
- Shopify connects from the dashboard only, not through the Management API.
- Fuul has no test mode, and ignores Shopify's test orders, so a test order never shows in Recent conversions. Your Shopify card's Last event still shows when Fuul last heard from your store. A real paid order is a real sale.
- Never send the same order through the API too. It would be credited twice.
Updated 4 days ago
