Shopify Integration

Follow the steps below to connect your Shopify store with XP Network.

1. Install the XP Network Shopify App

   Plus Plan Required

   The Shopify integration requires an XP Network organization on the Plus plan or higher.

   Open your XP Network Hub and select Shopify. If no store is connected yet, select Connect your Shopify Shop to open the XP Network Rewards app in the Shopify App Store.

   Install the app and accept the permissions presented in the dialog.

   

2. Request Your API Keys

   Before proceeding with any further configuration, you must obtain your XP Network API keys for Shopify.

   Reach out to us through one of the following channels:

   • Email: support@xpnetwork.com
   • Discord: discord.gg/vHYbJaHcEm

   API Keys Required

   Without your API keys, you will not be able to properly complete your store integration with XP Network. Do not proceed to the theme setup steps until you have received them.

3. Display Your Products on xpnetwork.com

   Create a collection in your Shopify store named XPN and add all products you want to show on your organization page on xpnetwork.com. Consider starting with your bestsellers to maximize customer engagement.

4. Set Up Discount Configuration

   Navigate to your store’s Discounts section to define how XP converts to cart discounts. This controls the customer reward experience. Customers sign in with their XP Network account and can only spend XP your organization gave them.

   • Select Redeem XP Rewards
   • Set the type to Automatic
   • Give it a name that includes XP in the title
   • Choose what XP Discount Applies To:
     • Order (entire cart), so customers can use XP on their whole cart
     • Product (specific products), so customers can use XP on All products or only on Specific collections you select
   • Set a rate for each currency your store sells in, such as USD Discount Rate (XP=$1). You choose your own rate, up to 1000 XP per unit of currency.

   

   Important

   Your XP blocks can’t show prices or apply XP until your Discount configuration is saved and your organization is connected. A currency without a rate earns no XP on orders, and customers can’t use XP at checkout in that currency. Only one XP discount can be configured per shop.

5. Set Up Your Theme

   Once you have received your XP Network API keys and set up your Discount configuration, follow the instructions in the Shopify app to add the XP Network theme blocks to your store.

   The XP Network Login block is required. You can also add these optional blocks to your product pages:

   Block	What It Shows
   XP Price Display	The product’s price in XP
   XP Minimum Spend Badge	The minimum XP needed to buy the product. See Minimum XP Spend.
   XP Earn Preview	About how much XP customers will earn from the product or their cart. Only shows once you turn on the Loyalty Program.

6. Connect Your Organization

   Once your configuration is complete, open the XP Network Rewards app in your Shopify Admin and select Connect on its Home page. When you’re redirected to XP Network, choose the organization to connect. You need to be the organization’s owner.

   After a successful connection, the app shows your organization as connected, and the Shopify page in your Hub shows your store URL, collection, discount configuration, and rate. These are read-only in the Hub. Change them in Shopify, and allow up to 30 minutes for changes to show.

   

7. Turn On the Loyalty Program

   This step is optional. To give customers XP on their purchases, turn on the XP Network Loyalty Program. In the XP Network Rewards app, go to Loyalty Program & Billing and select Manage Subscription. Select Activate Loyalty Program, choose a plan, then approve the subscription when Shopify asks.

   Once it’s on:

   • Customers earn XP when their order is paid, as long as the email on the order matches their XP Network account. In Shopify POS, XP goes to the member whose XP Card staff scanned. XP is based on what customers pay for products, not shipping or tax.
   • The XP customers earn comes from your organization’s XP balance, which your plan tops up every month. If it runs out, orders stop earning XP until your next monthly top-up. You can check your balance in the XP Ledger.
   • Refunding or canceling an order doesn’t change the XP the customer earned or spent.

   Without the Loyalty Program, customers can still spend XP on your store, but they don’t earn XP from purchases.

Disconnecting Your Store

To disconnect your store from XP Network, uninstall the XP Network Rewards app from your Shopify Admin. To reconnect later, reinstall the app and select Connect again.

To stop customers from earning XP but stay connected, go to Loyalty Program & Billing in the app, select Manage Subscription, then Cancel Subscription.

Next Steps

Once your store is connected, you can configure advanced features:

• Minimum XP Spend - Gate products behind XP requirements
• Featured Drops - Create limited-time product releases with countdown timers
• How to Use Your XP - See how customers earn and spend XP on your store