Shopify setup guide, step by step
From connecting your store to a loyalty card in your customers' Apple Wallet and Google Wallet: online checkout, the order pages, and Shopify POS. Updated 2026-11-19. Also in French and Portuguese.
What you will have at the end
- Your Shopify store connected to Pass Studio, with paid orders reaching Pass Studio automatically.
- A loyalty card (stamps, points, points and tiers, or prepaid credits) that customers keep in Apple Wallet or Google Wallet, and that updates on their phone when they earn.
- The card offered on the page the customer sees right after paying (Shopify's Thank you page) and on the Order status page.
- At the register (Shopify POS): a Pass Studio tile that scans a customer's card, and a Display QR Code row after a sale that shows the card QR to the customer.
What you need: a Shopify store, a Pass Studio account (free to create at www.thepassstudio.com), and, for step 4, Shopify POS on any subscription (POS Lite or POS Pro). Shopify admin labels below are quoted in English; if your Shopify admin is set to another language, the same items are in the same places.
Step 1. Connect your store
- Sign in to Pass Studio at www.thepassstudio.com.
- Click your avatar (top right), then Settings, then Integrations in the left sidebar.
- Click the Shopify row to open it.
- Type your store domain, for example
mystore.myshopify.com(it is in the address bar of your Shopify admin). - Click Connect with Shopify. Shopify opens and asks you to approve the app: click Install app.
- You come back to Pass Studio. The Shopify row shows your store with a green Connected badge and, under What's enabled, ✓ Auto-issue passes on purchase (webhook active).
- Nothing to copy: no API token and no webhook to create. Connecting registers Shopify's
orders/paidwebhook for you. - Installing from the Shopify App Store works too: click Install on the Pass Studio listing; without a Pass Studio account you land on the sign-up page, and the store connects as soon as the account exists.
- One store, one account: a store is connected to one Pass Studio account at a time. If it already belongs to another account, Settings names the current holder and the store moves only after you click Take over this store.
- Teams: the store belongs to the context selected in the Team Switcher when you connect. Connect while your team is selected so every member sees it and orders bill the team wallet.
- If you see a panel named Set up auto-issue on purchase instead of the ✓ line, automatic registration did not complete: follow the panel, or the manual steps on Shopify Setup, then press Refresh.
Step 2. Create the loyalty card
- Open Loyalty in the Pass Studio menu and click + New program. (The same wizard opens from Passes → New pass → Loyalty / Membership, after you name the card and click Create pass.)
- First question: First, let's understand what type of pass you want to build. Choose Create a loyalty program. (Membership card makes a member card with optional tiers and points; I already have a loyalty program is for Smile, Yotpo, LoyaltyLion or your own system, which keep the balance.)
- What kind of program do you have in mind? Pick one:
- Stamp card: a stamp per visit, a reward when the card is full.
- Points: points per visit or per amount spent, a reward at a threshold.
- Points and tiers: points plus levels such as Silver and Gold.
- Prepaid credits: customers buy a package and use it up (washes, classes, pizzas, drinks).
- Answer the remaining short questions. For points: How do holders earn points? Per visit or Per amount spent; then the welcome bonus and Member photo on the card?
- Send the card automatically after a purchase? Choose Yes. This is what makes a paid Shopify order issue the card. The wizard then asks which orders: every order, or only orders containing products you pick, and whether to invite the store's existing customers by email when the card goes live.
- Go through the detail steps (earning rule, reward, and for prepaid credits the packages and the Shopify products that sell them) and the review, then create the program.
- The wizard shows Your program is set up. Design the card, then Publish. Click Go to the card, add your logo and colors in the Studio, and click Publish. Drafts are free; publishing costs 10 credits.
- Change the orders that issue the card later: Settings → Integrations → Shopify → Set up or change auto-issue, or on the card itself: Studio → Journey & Distribution → Share tab → Auto-issue on purchase (switch Automatically email this pass on purchase and a Search your products… box). No product picked means every paid order.
- The invitation email: when a paid order matches the card, a customer who has no card yet receives an email from Pass Studio to sign up for it; a customer who already holds an active card gets no second one. The email address is the order's email, else its contact email, else the email of the customer attached to the order.
- One card per customer: a customer holds one live loyalty card per store. An order never offers a second loyalty card to someone who already has one.
- Reward at checkout: an unlocked reward applies by itself to the order of a known customer (switch Apply the reward automatically when the customer is known, on by default). Details in Automatic loyalty reward.
Step 3. Show the card on the order pages
This places the Pass Studio wallet buttons block on Shopify's Thank you page (right after payment) and on the Order status page (the order in the customer account). Shopify leaves checkout layout to the merchant, so an app cannot place it for you; it takes two minutes, once.
- In Shopify admin, go to Settings → Checkout.
- Under Configurations, click Edit on your store's configuration. The checkout editor opens on the Checkout page.
- In the page picker at the top of the editor, choose Thank you.
- Under the Order summary section, click Add block and select Pass Studio wallet buttons.
- In the same page picker, choose Order status. Under Main, click Add block and select Pass Studio wallet buttons.
- Click Save. The blocks are not live before you save.
What your customer sees, under the heading Your purchase comes with a card:
- A customer with no card sees Add your card to your wallet. It opens the card's sign-up form with the order's email and phone already filled in and read-only; the card is linked to that Shopify customer.
- A customer who holds the card sees Add to Apple Wallet and Save to Google Wallet for that card, on every order, so a card that was never added, or was removed from the phone, can be added again.
- The first order counts: when the card earns points on orders, the order the customer signed up from earns on the new card, once. Using both the email and the button never counts it twice.
- Which orders show it: orders with a product of a prepaid package; orders that match a card with auto-issue on (Step 2); orders that issued a pass of their own, such as a coupon or a ticket. Any other order shows the badges of the card the customer already holds, and nothing to a customer with no card.
- Timing: right after payment the block shows Preparing your wallet card… for up to 30 seconds while Shopify finishes the order.
- In the editor preview the block shows a waiting line: the sample order there is not a real order. Check it with a real test order (Step 5).
- Language: the block's heading and button are in English.
Step 4. Set up Shopify POS
Two settings, both in Shopify admin (not on the POS device), once per store. They work on POS Lite and POS Pro.
4a. Add the Pass Studio tile (scan a card at the register)
- In Shopify admin, open the Point of Sale sales channel → Customize your POS experience → Open editor.
- In the smart grid, click Add tile on a page and pick Pass Studio (search or scroll if it is further down the list).
- Click Save. The layout syncs to every POS device at the location; if the tile does not appear within a minute, log out of the POS app and back in.
4b. Turn on the QR after a sale
- In the same POS editor, open the Apps icon → Pass Studio.
- Switch on Activate on: Post-purchase.
- Click Save. Without this, the Display QR Code row does not appear after a sale.
At the register
- A customer shows their card: tap the Pass Studio tile, scan the card (or type the member code), then tap Attach & apply discount. The customer is set on the sale and their reward or coupon code is applied; complete the sale as usual and the points land on the card.
- No customer on the sale: when the cart has items and no customer, the tile turns highlighted and reads No customer on this sale · Add the customer. A sale earns only when a customer is on it: scan the card, or attach the customer with Shopify's own customer search.
- After a sale with a prepaid package: tap Display QR Code on the sale-complete screen. The screen shows the card name, the credits bought and a QR code. The customer scans it with their phone camera and gets the card with the credits on it. The same QR is on the order later: POS → Orders → the order → Display QR Code; a QR scanned twice never adds the credits twice.
- After any other sale, the same QR lets a walk-in customer join. When the sale has no prepaid package and matches a loyalty card with auto-issue on (Step 2), Display QR Code shows a QR for that card, with or without a customer on the sale. With no customer attached: the customer scans the QR with their phone camera, fills in the card's sign-up form (only the fields you made required are asked for), and adds the card to their wallet. When the card earns on orders, the points or the stamp of that sale are on the new card, counted once, and the customer is now a holder you can see in the card's Holders. When the sale carries the customer's email or phone, the form opens with them filled in.
- A customer who already has a card (the tile scanned it on the sale, or the customer on the sale holds one) gets the QR of that card: scanning it opens the card, or adds it to the phone again. No second card is made, and the sale has already earned on the card.
- When there is no QR: the screen answers This sale has no package for a card. when the sale has no prepaid package and no loyalty card is issued on it: auto-issue is off for the card, or the card is limited to products that are not in the sale. A sale that is not fully paid, or that was refunded, adds no points at sign-up.
- Check your setup: Settings → Integrations → Shopify → Set up POS scanning shows POS not set up, POS not fully set up or POS set up, from what your POS devices report. It updates after the POS is opened with the tile, or after a sale with the QR row shown. A store with no POS sale in the last 60 days shows POS not in use.
- Looking up a card at the register is free. Points and redemptions are counted from the paid order, like online orders.
Step 5. Test it
- Online: place an order in your store with an email you can read, on a product that matches the card. On the Thank you page, the block shows Your purchase comes with a card. Tap the button, complete the form, and add the card to your wallet.
- In Pass Studio, open the card's Holders: the new holder is there, and when the card earns on orders, the test order's points are on it.
- At the register: start a sale, tap the Pass Studio tile and scan the card you just added. The customer attaches to the sale.
- Prepaid credits: sell a package product on the POS, tap Display QR Code, and scan the QR with a phone.
- Walk-in customer: ring up a sale on the POS with no customer attached, on a product that matches the card. Tap Display QR Code, scan the QR with a phone that does not have the card yet, and complete the form. The new holder is in the card's Holders, with the points of the sale.
FAQ
- Do I need to create a webhook in Shopify? No. Connecting the store registers it. Only if Settings shows the Set up auto-issue on purchase panel do you add it by hand, following that panel.
- The block is not on my Thank you page. It is not there until you add it and click Save in the checkout editor (Step 3). Add it on both pages: Thank you and Order status.
- The block says "Your card is not ready yet". Shopify took longer than 30 seconds to finish the order. Opening the page again a minute later shows the card.
- The Pass Studio tile is not in the POS. Add it from Shopify admin (Step 4a), not from the device's own Add tile sheet, which often does not list new app tiles. Allow a few minutes after installing the app.
- There is no Display QR Code after a sale. Turn on Activate on: Post-purchase (Step 4b). If the row is there and answers This sale has no package for a card., the sale had no prepaid package product and matched no loyalty card with auto-issue on (Step 2).
- A customer already has a card. Will they get a second one? No. A customer holds one live loyalty card per store; the order pages show the card they hold.
- Does it work with Smile, Yotpo or LoyaltyLion? Yes: in Step 2 choose I already have a loyalty program. The card identifies the customer at checkout and your app keeps the balance. See Smile + Pass Studio.
- What does it cost? Publishing a card costs 10 credits; each card issued costs 1 credit; processing orders is free. See Billing.
Go further
- Shopify Setup reference: how issuance decides, discount codes, automatic reward, manual webhook.
- Shopify Flow: nine triggers and five actions on card events.
- Staff app: scan cards at a counter without Shopify POS.
Changelog: 2026-11-19 — guide published, replacing the 2026-06 PDF guide; covers connecting, the loyalty wizard, the Pass Studio wallet buttons block on the Thank you and Order status pages (since 2026-11-18 on every order the store issues a card on), and Shopify POS (tile, and the QR after a sale for prepaid packages). 2026-11-19 — the QR after a sale also serves a loyalty card issued on orders: a walk-in customer with no customer on the sale scans it, joins, and the points of the sale are on the new card.