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

  1. Open the Dev Dashboard of the Shopify account that owns your store.

  2. Choose Apps → Create app, and name it Fuul.

  3. Paste these two values, which Fuul's connect dialog also shows with a copy button:

    FieldValue
    App URLhttps://app.withfuul.com
    Scopesread_orders,read_customers,write_discounts
  4. Untick Embed app.

  5. Choose Create app, then Release.

ScopeWhy Fuul needs it
read_ordersTo read each paid order as a sale
read_customersTo know who the customer is
write_discountsTo 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

  1. In Fuul, open Settings → Conversion sources and choose Connect a source, then Shopify. During setup, pick Shopify in the Source step.

  2. Fill in the three fields:

    FieldWhere to find it
    Store addressYour store's address ending in .myshopify.com. Your Shopify admin shows it in Settings → Domains
    Client IDThe app's overview, under Credentials
    Client secretThe app's overview, under Credentials
  3. 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:

MessageWhat 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.

  1. Turn it on.
  2. 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.
  3. 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 itAny buyer who types the code
What it applies toThe order's products, never shipping
Other discountsIt doesn't combine with them
One-time ordersGet it once
Pausing a codeDeactivates its discount. Shopify lists it as expired
Editing the discountUpdates every code's discount, in a few moments
Turning it offDeletes 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.

Did this page help you?