Shopify Setup

What the integration does

• Auto-issue on paid orders — a customer completes checkout and receives a branded email with official wallet buttons. Smart issuance logic skips customers who already hold a pass: if the order used a Pass Studio discount code, the customer clearly has one.
• Discount-code sync — pass barcodes double as Shopify discount codes, valid at online checkout and Shopify POS.
• Closed-loop loyalty — orders that redeem a pass code accrue points or advance the customer toward their next reward, and the pass updates on their phone automatically.

1. Connect your store

1. In Pass Studio, open Settings → Shopify and click Connect.
2. Approve the app on Shopify — you're redirected back when the store is linked.
3. Open the pass you want customers to receive and turn on Auto-issue on purchase (Studio → Distribute). Optionally pick specific products — the pass is then only sent when an order contains one of them; with no products picked, every paid order sends it.

2. Auto-issue (orders webhook)

Auto-issue is driven by Shopify's orders/paid webhook. It is registered automatically when you connect your store — nothing to set up. Every delivery is signature-verified; deliveries with a bad signature are rejected.

Manual fallback: if Settings → Shopify shows the auto-issue setup panel (automatic registration didn't complete, or the store was connected before automatic setup existed), follow the panel's steps: copy the webhook URL, create a webhook for the Order payment event in Shopify admin (Settings → Notifications → Webhooks, JSON format), paste the webhook signing secret from Shopify's Webhooks page into the matching field in Pass Studio, then click Refresh.

3. Test it

1. Place a test order in your store and mark it paid.
2. The customer email on the order receives the wallet pass email within seconds.
3. Check Members on the pass in Pass Studio — the holder appears with their name and email.

How issuance decides

For every paid order, Pass Studio checks the discount codes on the order:

• A Pass Studio code was used → the customer already holds a pass. No new pass is issued; instead the order runs through the loyalty engine — points accrue or the reward progresses.
• No Pass Studio code → first-time customer. A pass is issued and the branded wallet email goes out.

Issuance costs 1 credit per issued pass; order processing itself is free. For a limited time, connecting a store adds the one-time Shopify Welcome Bonus (5,000 credits at launch) to an individual account — once per account and once per store, not for team wallets, Basic accounts or development stores. Billing details →

Automatic loyalty reward

On a Shopify store, a loyalty member's unlocked reward (the offer unlocked at the points threshold) applies by itself, with no code typed or scanned, once the customer is on the order. It is powered by a Shopify discount function included in the Pass Studio app (rolling out from 2026-10-24, with the app release that carries it).

• Where it applies: online checkout when the customer is logged in or otherwise identified (including a guest checkout with the customer's email), and Shopify POS on POS Pro locations once staff attach the customer to the sale (Shopify's customer search or the Pass Studio tile). POS Lite locations don't run automatic discounts — a Shopify rule for all automatic discounts; there, staff scan the member's card with the Pass Studio tile, which applies the same code.
• One reward, one code: the automatic discount carries the member's own reward code — the same code printed on their wallet card. Used either way, the reward is redeemed once; the other way then stops working.
• Redeemed only on a paid order: appearing on a cart uses nothing up. An abandoned cart, or a discount removed from a POS sale because the customer wants to keep the reward, leaves the reward available. Online, shoppers can't remove an automatic discount — Shopify gives them no option for it — so an identified member's reward always applies to their online order.
• What never applies automatically: the welcome offer and campaign codes. Only the reward does.
• No stacking: it combines with no other discount. If the customer has a better non-combining discount, Shopify keeps the better one and the reward stays for the next order. If they also enter their reward code, only one applies.
• On by default: each program has a switch, Apply the reward automatically when the customer is known, on the Reward step of the loyalty wizard, and autoApplyReward on GET/PATCH /v1/loyalty/programs/{id}. Off, or a paused program, stops automatic application; codes keep working.
• In Shopify admin: Pass Studio creates one automatic discount, titled Loyalty reward, the first time a reward unlocks in your store.
• Who gets it: members linked to a Shopify customer (learned from an order, from the POS tile, or by email match when the reward unlocks). A member with no Shopify customer record keeps the code only.

FAQ

• Does the welcome offer apply automatically? No — only the reward. The welcome offer stays a code.
• The reward didn't apply. Why? No customer on the order (guest checkout, or none attached at POS), a POS Lite location (automatic discounts need POS Pro), the switch is off or the program paused, a better non-combining discount won, or the member has no Shopify customer record. The code on the card still works.
• Can a customer keep the reward for later? At POS, yes — staff remove the discount from the sale; nothing is redeemed until an order is paid. Online, no — Shopify doesn't let shoppers remove an automatic discount, so it applies whenever the member is identified at checkout.
• Can it be used twice? It is cleared by the paid-order webhook a few seconds after payment; a second order by the same customer inside those seconds could receive it again. Codes are single-use inside Shopify itself.

Changelog: 2026-10-24 — automatic loyalty reward added (reward only, on by default, one code for both ways in). 2026-10-25 — clarified: at Shopify POS it needs a POS Pro location. 2026-10-25 — Shopify Welcome Bonus (limited time): one-time credits when a store connects, see Billing.

Shopify Flow

Pass Studio adds nine triggers to Shopify Flow: pass issued, added to wallet, removed, redeemed, points changed, tier changed, reward unlocked, visit counted, journey advanced. Each fires for one holder with the Shopify customer attached, so a workflow can tag the customer, update a metafield or send an email through Klaviyo. Five actions run the other way: issue a pass, send a message, update fields, add points, revoke. See Shopify Flow.

Selling somewhere else too?

The same engine accepts orders from any platform via POST /orders/process — WooCommerce, a custom cart, in-person sales. See the Integration Guide.