Distribution

Deliver Secutix tickets to Apple Wallet and Google Wallet via email links or embedded “Add to Wallet” buttons.

Distribution is how buyers add Secutix tickets to Apple Wallet and Google Wallet. You can share a hosted download link, or embed an Add to Wallet button. Place the CTA where buyers already are.

Common touchpoints:

• Confirmation email (hosted link)

• Secutix ticket shop order confirmation page (embedded button)

• Your website (embedded button)

• SMS link (useful few hours before the show)

Most deployments combine multiple channels: Hosted download page in transactional emails for reliability and embedded “Add to Wallet” button (SDK) for instant saves in the ticket shop or owned pages.

Hosted download page (send via email)

This is the simplest path for buyers. It works well when Secutix already sends a confirmation email after purchase.

This page does not require authentication. Buyers can open the email a few minutes before the show and add tickets to their wallet. They do not need to remember their ticket shop login and password.

The Wallet Crew exposes an order page optimized for mobile. On iOS, it shows the Apple Wallet button. On Android, it shows the Google Wallet button. On desktop, it falls back to a QR code.

The page lists every ticket in the order. Buyers can add tickets from the same link, without re-opening the email.

Hosted download page on iOS.

Hosted download page on Android.

Hosted download page on desktop.

URL template

Use this URL in Secutix confirmation emails. Replace <customdomain> and <tenantId> with your values.

https://<customdomain>/<tenantId>/tickets?ids.secutix.orderToken=$document.order.secretToken

Layout requirement

The hosted page uses a layout named tickets. Create it in your Wallet Crew layouts.

Layout configuration (example)

type: passList
internationalization:
  resources:
    - /locales/tickets/
headerImage: /public/header.png

Contact The Wallet Crew support if you need help configuring this layout.

“Add to Wallet” in the ticket shop

Use this when you want the CTA directly in the ticket shop UI. This is the best flow for mobile buyers who want to save the ticket right away.

This integration is typically implemented by Secutix. Confirm it is included in your Secutix scope if you do not see it.

“Add to Wallet” button in the ticket shop.

Add the “Add to Wallet” button on your website

Use this when you control the page. Typical examples are an account page, a “My tickets” page, or a post-purchase landing page.

The Wallet Crew SDK (cinto) renders the button and detects the device. It shows Apple Wallet on iOS and Google Wallet on Android. On desktop, it falls back to a QR code.

It follows Apple and Google button guidelines. It stays compatible through SDK updates. It supports localization based on the user language. It also protects distribution integrity.

Prerequisites

Before integrating the SDK, confirm three things. Your Wallet Crew tenant has the right Event Ticket template(s). Wallet Crew is connected to Secutix through the Secutix connector. You can modify the page where you want to render the button.

The Wallet Crew Secutix integration uses Secutix movementId to uniquely identify a ticket pass.

Script initialization

Copy the ready-to-use snippet from the Secutix integration settings in the admin console. Load it once per page, ideally in the page footer.

SDK snippet available in the Secutix integration settings.

<script type="text/javascript">
(function (n, e, o) {
    var s=n.createElement("script");
    s.src="https://sdk.neostore.cloud/scripts/"+e+"/cinto@1";
    s.async=1;
    s.onload=function(){neostore.cinto.initialize(e,o);n.body.appendChild(s);};
})(document, "{tenantId}", { });
</script>

Replace {tenantId} with your Wallet Crew tenant ID.

Button examples

All options below render the same button. They only differ in how the button identifies the ticket.

Using movementId, fileId, contactId, and ticketId

<div data-neostore-addToWalletButton
     data-neostore-externalIdentifiers-secutix.movementId-value="<movementId>"
     data-neostore-externalIdentifiers-secutix.movementId-secret="<fileId>|<contactId>|<ticketId>">
</div>

Using HMAC calculation

<div data-neostore-addToWalletButton
     data-neostore-externalIdentifiers-secutix.movementId-value="<movementId>"
     data-neostore-externalIdentifiers-secutix.movementId-hmac="<hmac_sha256(secret, movementId)>">
</div>

Using passId only (resolved server-side)

<div data-neostore-addToWalletButton
     data-neostore-passId="<passId>">
</div>

Notes

Keep HMAC computation server-side. Never expose your signing secret in the browser.

If you need passId, retrieve it server-side by querying existing passes using the Secutix movementId (this does not create a pass):

curl 'https://app.neostore.cloud/api/{tenantId}/passes?pageIndex=0&pageSize=21&filter%5B0%5D.field=identifiers.secutix.movementId&filter%5B0%5D.operator=equals&filter%5B0%5D.value={movementId}' \
  -H 'accept: application/json, text/plain, */*' \
  -H 'X-API-KEY: xxxx'

Pick the id from the response payload. That value is the passId to feed to the SDK. API reference: GET /api/{tenantId}/passes.

Need the full website integration guide? See On your website.

FAQ

Why does the hosted download page link not work (ticket not found / token invalid), and how do we fix it?

This means the hosted page cannot resolve the order from the token. The token in the URL is missing or wrong.

Use the exact URL template from this page. Ensure the token variable is populated. Ensure your email tool does not truncate the URL. If the order was replaced, send the buyer a fresh link.

Why does the “Add to Wallet” button show the wrong platform (or only a QR code)?

The button selects Apple vs Google vs desktop from the user agent. Embedded browsers can make this detection wrong. “Request desktop site” also breaks detection.

Have the buyer open the page in the system browser. Use Safari on iOS. Use Chrome on Android. On desktop, the QR code is the expected fallback.

If it still don't work a "need help" button is available and button for Google and Apple wallet will be displayed.

A buyer has multiple tickets in one order. Can they add all tickets at once?

Yes. One hosted link can show every ticket in the order.

Buyers add tickets from the list. They do not need one link per ticket.

What happens when a ticket is exchanged, reprinted, or cancelled after it was added to the wallet?

Reprints and simple edits typically update the existing wallet pass automatically.

Exchanges or replacements usually generate a new ticket. The old pass is then deactivated. The buyer must add the new pass. Re-opening the hosted link is usually enough.

Cancellations deactivate the pass so it can’t be scanned.

For the full behavior matrix, see Updates, lifecycle, and installation status.

More information

If you still need to configure the pass content, go to Wallet pass template & field mapping.

If you want to validate exchanges, cancellations, and refresh behavior, go to Updates, lifecycle, and installation status.