Skip to content
SleekPass SleekPass

Adding Wallet Buttons to Order Confirmation Emails

When a customer places an order, Shopify sends them an order confirmation email. You can add “Add to Apple Wallet” and “Save to Google Wallet” buttons to that email so customers can save their loyalty card immediately after purchase.

What This Does

Section titled “What This Does”

Customers receive their standard order confirmation email with two wallet buttons at the bottom. Tapping a button generates their loyalty card on the fly and either downloads the .pkpass file (Apple) or opens the Google Wallet save page (Google). If the customer already has a card, it updates their existing one instead of creating a duplicate.

The buttons use deterministic URLs — no login or authentication token is required. Each link includes a proof hash derived from the customer’s email address, so the URLs only work for the intended recipient.

Step 1: Copy the Liquid Snippet

Section titled “Step 1: Copy the Liquid Snippet”

In your SleekPass admin, go to the Distribution page. Under Order Confirmation Email, click Show Liquid snippet. Click Copy snippet to copy it to your clipboard.

Step 2: Paste into Your Shopify Email Template

Section titled “Step 2: Paste into Your Shopify Email Template”
  1. In your Shopify admin, go to Settings > Notifications > Order confirmation.
  2. Click Edit code to open the HTML editor.
  3. Paste the snippet before the closing </body> tag. This places the wallet buttons at the bottom of the email, after the order summary and shipping details.
  4. Click Save.

Step 3: Test

Section titled “Step 3: Test”
  1. Place a test order in your store (you can use a 100% discount code or Shopify’s Bogus Gateway to avoid real charges).
  2. Check the order confirmation email. You should see “Save your loyalty card:” with the two wallet buttons.
  3. Tap Add to Apple Wallet — it should download a .pkpass file that opens in Apple Wallet.
  4. Tap Add to Google Wallet — it should redirect to Google’s “Save to Wallet” page.

If you do not receive the email, check Settings > Notifications in Shopify admin to confirm the order confirmation notification is enabled.

How It Works

Section titled “How It Works”

The Liquid snippet generates a deterministic download URL for each customer. The proof parameter is a SHA-256 hash that prevents URL enumeration — someone who only knows a customer ID cannot generate a valid download link without also knowing the customer’s email address.

When a customer clicks the link:

  1. SleekPass looks up the shop and customer.
  2. It verifies the proof hash using the customer’s email from Shopify.
  3. If valid, it generates (or retrieves) the customer’s loyalty card.
  4. For Apple: returns the .pkpass file as a download. For Google: redirects to the Google Wallet save URL.

Troubleshooting

Section titled “Troubleshooting”

Buttons not appearing in the email

Section titled “Buttons not appearing in the email”
  • Confirm you saved the template after pasting the snippet.
  • Check that the snippet is inside the <body> tag, not after </body>.
  • Some email clients strip HTML tables aggressively. Send a test to a Gmail or Apple Mail account to verify.

Clicking the button returns “Missing proof” or “Invalid proof”

Section titled “Clicking the button returns “Missing proof” or “Invalid proof””
  • Make sure you copied the entire snippet, including the three {% assign %} lines at the top.
  • The proof is case-sensitive on the email. The snippet applies | strip | downcase to normalize it. If you modified the snippet and removed those filters, the proof will not match.

Clicking the button returns “Shop not found”

Section titled “Clicking the button returns “Shop not found””
  • Your store must have SleekPass installed and active. If you uninstalled and reinstalled the app, open SleekPass in your Shopify admin to trigger a session, then try the link again.

Badge images not loading

Section titled “Badge images not loading”
  • The badge images are hosted at https://app.sleekpass.com/images/badges/. If your email client blocks remote images by default, the customer will need to click “Load images” in their email client.
  • The alt text (“Add to Apple Wallet” / “Add to Google Wallet”) will display as fallback text if images are blocked.