Integrations

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.

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.

FieldWhat it does
NameWhat you call the rule internally.
DescriptionWhat the rule is for, for whoever inherits it.
RecurrenceOne time pays a given fan once, ever. Recurring pays every time an order matches.
RewardWhat 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 build

A 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 build

Discount and gift codes handed out as a reward. See Rewards.

On this page