Shopify
Store sign-in, reward rules on purchases, orders from in-app purchases, and FanBase on your storefront.
Connecting Shopify does three independent things: fans sign in with their store account, purchases in your store pay out XP, currency or collectibles in the app, and items bought with points in the app become real orders in your store.
Sign-in
A fan taps Sign in with Shopify. They go to your store through an app proxy URL, which looks like https://yourstore.com/apps/proxy-redirect. They authenticate with the account they already have, or create one, and they come back signed in.
It works with standard Shopify accounts and with Shop, Shopify's own login. Either way the fan arrives as one identity: their purchases and their points are the same person.
One thing to know before you brief support. When a fan creates a brand new Shopify account during this flow, Shopify does not return them to your app afterwards. They land back on your store, sign in once more, and everything works from then on. Fans who already have an account never see this.
Whose account a customer gets
The first time a customer signs in this way, they are matched to a fan by email. A customer whose email already belongs to a fan gets that fan's account, with its points and history. Anyone else gets a new one, with that email.
Whether Shopify appears alongside Google, Discord, X and Twitch, or replaces them entirely, is a per community setting. Some partners run Shopify as the only way in, so that a fan account and a customer account are the same thing by construction.
Installing it
The install is a custom Shopify app for your store, which means it is a handful of messages rather than a listing you search for.
Send us your .myshopify.com domain
The original one, ending in .myshopify.com.
Find it in your Shopify admin under Settings, then Domains. The .myshopify.com address is listed there even when a custom domain is your primary.
Your custom domain will not work. The install is keyed to the original Shopify domain, and the wrong one costs a week rather than an afternoon.
We whitelist it and send you an install link
The link is unique to your store and expires in about a week. If it lapses, ask for another one.
Log in to the admin panel before you click it
Open admin.gamerbase.gg/admin and sign in first, in the same browser. The install finishes by handing you back to the admin panel, and it cannot do that if you are not already authenticated there.
Approve the permissions in Shopify
The link takes you to Shopify's authorisation screen. Read what the app is asking for, then install it.
Land back in the admin panel
You are redirected back and the installation completes on its own. Nothing else to fill in.
Verify it
In the admin panel, go to Settings, then Automations. Shopify should show as connected. If it does not, the install did not finish, and the usual cause is step three.
Sandbox and production are separate apps, and they do not cross. A sandbox app connects to a Shopify development store only, and the production app connects to your live store only. Create a development store for testing rather than pointing the sandbox at your real one. It is free and already in test mode.
Reward rules
A reward rule watches your store and pays out when an order matches it. Create them in the Shopify section of the admin panel. Every rule takes a name, a description and a recurrence.
| Field | What it does |
|---|---|
| Name | What you call the rule internally. |
| Description | What the rule is for, for whoever inherits it. |
| Recurrence | One time pays a given fan once, ever. Recurring pays every time an order matches. |
| Reward | What the fan gets. See the note on reward types below. |
There are three rule types.
Tagged purchase
Rewards an order that contains products carrying a tag you choose. You pick the tags, and you pick whether an order has to match any of them or all of them.
This is how you reward a category without listing products. Tag the jerseys, write one rule, and every jersey you add later is covered.
Any purchase
Rewards every order regardless of what was bought. The simplest of the three, and the right one for "shopping with us at all earns points".
Amount spent
The reward scales with the order total. You set a rate per unit of your shop currency, and the payout is the rate multiplied by the order total, rounded down. There is no cap on a single order today, so pick the rate with a large order in mind.
Reward types
XP, your spendable currency and collectibles. A prize or a loot box for a purchase is a manual reward for now. Rewards covers the difference between the types.
When a purchase pays nothing
A fan says they bought something and got nothing. Seven things are checked for every order, in order, and the first one that fails is the answer.
- OK
- OK
- Stops here
- Not reached
- Not reached
- Not reached
- Not reached
Two of them account for nearly every case. The rule was created after the order, and orders from before a rule are never paid. Or the fan checked out with a different email from the one on their fan account, and the email is the only thing connecting the two.
A refund or a cancelled order does not take the reward back.
If your own site is built with the SDK, showing a fan the points a purchase paid them is the one piece your developers write. Purchase rewards in the SDK docs covers it, with the same seven checks from their side.
Two things to plan for
Orders created by in-app redemptions are skipped. When a fan buys a store item with points and the platform places the order in your store, no rule fires on it. Without that, a fan could spend points to buy something and earn points for the purchase, and loop.
There is no in-app notification when a purchase pays out. The fan's balance goes up and nothing in the app says where it came from. Partners cover this by mentioning the reward in the Shopify order confirmation email they already send. An in-app notification is on the list.
On your storefront
In buildFanBase features will be available as blocks you add to your Shopify theme in the theme editor, with no code: quests, a fan's profile and avatar, and a small account indicator for your header. A customer who is logged in to your store will be signed in to your community automatically, on your own pages, without a second login.
The first release covers quests, the profile, the avatar and the indicator. Blocks for the leaderboard, the store, the battlepass, events and the newsfeed follow.
One change to sign-in arrives with it. Matching a customer to an existing fan by email will apply only on stores that use Shopify's new customer accounts, where a customer proves their address with a code. On classic customer accounts, where a customer picks a password and nothing proves the address, each customer will get a fan account of their own. If you are on classic accounts and want store customers and existing fans to line up, switching to new customer accounts in your Shopify settings, under Settings then Customer accounts, is worth doing before the blocks reach your store.
It is rolling out store by store, starting with pilot communities. It installs from a link, like the connection above, and asks for no permissions on your store. Setup, each block's settings and how to style them to your theme are in Storefront blocks. Ask your FanBase contact where your store is in the rollout.
Spending points back into Shopify
A fan buys a store item with points inside the app, and a real order appears in your Shopify, against their customer record, ready for you to fulfil the way you fulfil any other order. Live since 7 October 2026.
The fan is never charged money. The order arrives in Shopify already marked as paid, because they paid in points.
Turning it on for an item
Authorise your store for orders
Creating orders needs a permission the original install did not ask for. The admin panel shows a banner on the Shopify section when your store needs authorising again. It is one approval in Shopify, done once.
Switch on Fulfil via Shopify
On the store item, switch on Fulfil via Shopify. The switch stays off until a store is connected, and says so.
Pick the product and variant
Choose the product from your Shopify catalogue, then the variant. The panel fills in the product title and SKU so you can check you picked the right one.
Save
Turning fulfilment on adds an email and a shipping address to what the item asks a fan for at checkout. You do not add those yourself.
What the fan does
They buy the item with points, as they would any other. Before the purchase goes through they are asked for an email and a delivery address, with a name for the parcel. If they have given those before, they are filled in.
What lands in Shopify
| On the order | Value |
|---|---|
| Customer | The fan, matched or created by their email |
| Shipping address | The address they entered |
| Payment status | Paid |
| Tag | fanbase-redemption |
The tag is how you tell these orders apart in your Shopify admin, and how FanBase knows not to run reward rules on them.
Following an order
Each purchase in the store's distribution tab shows its Shopify order and where that stands. If creating an order fails, for example because Shopify was unreachable, FanBase tries again on its own, and you can retry from the same tab. A fan who has paid in points does not lose the item because of a failed attempt.
Three limits to plan around
- One store item is one variant. A medium and a large are two store items, each mapped to its own variant. Variants on a single item are in build.
- Store purchases only. A physical prize won from a quest, an event or a loot box is not sent to Shopify. You fulfil those by hand, as before. See Prizes.
- The store item has its own stock. The quantity you set on the store item is what limits sales in the app. Set it to what you can actually ship.
Pair it with a purchase limit on anything scarce, so one fan with a large balance cannot take all of it.
Code distribution
In buildDiscount and gift codes handed out as a reward. See Rewards.