Shopify
Store sign-in, reward rules on purchases, and what is coming next.
Connecting Shopify does two independent things: fans sign in with their store account, and purchases in your store pay out XP, currency or collectibles in the app.
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.
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.
Two things to plan for
Orders created by in-app redemptions are skipped. When the platform itself places an 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.
Spending points back into Shopify
In buildA fan will be able to buy a store item with points inside the app, and a real order will appear in your Shopify against their customer record. The flow will include a shipping address form and a per fan purchase limit, so a single fan cannot clear the stock.
This is the feature partners ask for most, see Feature status. Ask your FanBase contact where it stands before you plan a campaign around it.
One piece of planning to do now: when it lands, your store will need a permissions re-authorisation, because creating orders needs write access that the current install does not have. It is a single approval, and we will tell you when.
Code distribution
In buildDiscount and gift codes handed out as a reward. See Rewards.