Distribution

Livrez les billets Secutix vers Apple Wallet et Google Wallet via des liens e-mail ou des boutons intégrés « Add to Wallet ».

La distribution est la façon dont les acheteurs ajoutent des billets Secutix à Apple Wallet et Google Wallet. Vous pouvez partager un lien de téléchargement hébergé, ou intégrer un Ajouter à Wallet bouton. Placez le CTA là où se trouvent déjà les acheteurs.

Points de contact courants :

E-mail de confirmation (lien hébergé)
Page de confirmation de commande de la billetterie Secutix (bouton intégré)
Votre site web (bouton intégré)
Lien SMS (utile quelques heures avant le spectacle)

La plupart des déploiements combinent plusieurs canaux : Page de téléchargement hébergée dans les e-mails transactionnels pour la fiabilité et bouton intégré « Ajouter à Wallet » (SDK) pour des enregistrements instantanés dans la billetterie ou sur les pages détenues.

Page de téléchargement hébergée (envoyée par e-mail)

C’est le parcours le plus simple pour les acheteurs. Cela fonctionne bien lorsque Secutix envoie déjà un e-mail de confirmation après l’achat.

Cette page ne nécessite pas d’authentification. Les acheteurs peuvent ouvrir l’e-mail quelques minutes avant le spectacle et ajouter les billets à leur Wallet. Ils n’ont pas besoin de mémoriser leur identifiant et leur mot de passe de la billetterie.

Le Wallet Crew expose une page de commande optimisée pour mobile. Sur iOS, elle affiche le bouton Apple Wallet. Sur Android, elle affiche le bouton Google Wallet. Sur ordinateur, elle bascule vers un code QR.

La page liste chaque billet de la commande. Les acheteurs peuvent ajouter les billets à partir du même lien, sans rouvrir l’e-mail.

Hosted download page on iOS showing the ticket list and Apple Wallet button.

Hosted download page on Android showing the ticket list and Google Wallet button.

Hosted download page on desktop showing the ticket list and QR code fallback.

Modèle d’URL

Utilisez cette URL dans les e-mails de confirmation Secutix. Remplacez <customdomain> et <tenantId> par vos valeurs.

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

Exigence de mise en page

La page hébergée utilise une mise en page nommée billets. Créez-la dans vos mises en page Wallet Crew.

Configuration de la mise en page (exemple)

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

Contactez le support The Wallet Crew si vous avez besoin d’aide pour configurer cette mise en page.

« Ajouter à Wallet » dans la billetterie

Utilisez cela lorsque vous voulez le CTA directement dans l’interface de la billetterie. C’est le meilleur parcours pour les acheteurs mobiles qui souhaitent enregistrer le billet immédiatement.

Cette intégration est généralement mise en œuvre par Secutix. Vérifiez qu’elle est incluse dans le périmètre Secutix si vous ne la voyez pas.

Add to Wallet button embedded in the Secutix ticket shop order confirmation page.

Ajoutez le bouton « Ajouter à Wallet » sur votre site web

Utilisez cela lorsque vous contrôlez la page. Les exemples typiques sont une page de compte, une page « Mes billets » ou une page d’atterrissage après achat.

Le SDK The Wallet Crew (cinto) affiche le bouton et détecte l’appareil. Il montre Apple Wallet sur iOS et Google Wallet sur Android. Sur ordinateur, il bascule vers un code QR.

Il suit les directives des boutons Apple et Google. Il reste compatible lors des mises à jour du SDK. Il prend en charge la localisation selon la langue de l’utilisateur. Il protège également l’intégrité de la distribution.

Prérequis

Avant d’intégrer le SDK, vérifiez trois choses. Votre tenant Wallet Crew dispose du bon Billet d’événement modèle(s). Wallet Crew est connecté à Secutix via le connecteur Secutix. Vous pouvez modifier la page où vous souhaitez afficher le bouton.

L’intégration Wallet Crew Secutix utilise Secutix movementId pour identifier de manière unique une carte de billet.

Initialisation du script

Copiez l’extrait prêt à l’emploi depuis les paramètres d’intégration Secutix dans la console d’administration. Chargez-le une fois par page, idéalement dans le pied de page.

SDK snippet shown in the Secutix integration settings page.

<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>

Remplacez {tenantId} avec l’ID de tenant Wallet Crew.

Exemples de boutons

Toutes les options ci-dessous affichent le même bouton. Elles diffèrent seulement par la façon dont le bouton identifie le billet.

En utilisant movementId, fileId, contactId, et ticketId

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

En utilisant le calcul HMAC

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

En utilisant passId uniquement (résolu côté serveur)

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

Notes

Conservez le calcul HMAC côté serveur. N’exposez jamais votre secret de signature dans le navigateur.

Si vous avez besoin passId, récupérez-le côté serveur en interrogeant les cartes existantes à l’aide du Secutix movementId (cela ne pas crée une carte) :

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'

Choisissez le id depuis la charge utile de réponse. Cette valeur est la passId à fournir au SDK. Référence de l’API : GET /api/{tenantId}/passes.

Besoin du guide d’intégration complet du site web ? Consultez Sur votre site web.

FAQ

Pourquoi le lien de la page de téléchargement hébergée ne fonctionne-t-il pas (billet introuvable / jeton invalide), et comment le corriger ?

Cela signifie que la page hébergée ne peut pas résoudre la commande à partir du jeton. Le jeton dans l’URL est manquant ou incorrect.

Utilisez le modèle d’URL exact de cette page. Vérifiez que la variable de jeton est renseignée. Vérifiez que votre outil d’e-mail ne tronque pas l’URL. Si la commande a été remplacée, envoyez à l’acheteur un nouveau lien.

Pourquoi le bouton « Ajouter à Wallet » affiche-t-il la mauvaise plateforme (ou seulement un code QR) ?

Le bouton choisit Apple vs Google vs ordinateur à partir de l’agent utilisateur. Les navigateurs intégrés peuvent fausser cette détection. « Demander la version ordinateur du site » casse aussi la détection.

Demandez à l’acheteur d’ouvrir la page dans le navigateur système. Utilisez Safari sur iOS. Utilisez Chrome sur Android. Sur ordinateur, le code QR est le repli attendu.

Si cela ne fonctionne toujours pas, un bouton « besoin d’aide » est disponible et les boutons pour Google et Apple Wallet seront affichés.

Un acheteur a plusieurs billets dans une seule commande. Peut-il tous les ajouter en une seule fois ?

Oui. Un seul lien hébergé peut afficher tous les billets de la commande.

Les acheteurs ajoutent les billets depuis la liste. Ils n’ont pas besoin d’un lien par billet.

Que se passe-t-il lorsqu’un billet est échangé, réimprimé ou annulé après avoir été ajouté au Wallet ?

Les réimpressions et les modifications simples mettent généralement à jour automatiquement la carte Wallet existante.

Les échanges ou remplacements génèrent généralement un nouveau billet. L’ancienne carte est alors désactivée. L’acheteur doit ajouter la nouvelle carte. Rouvrir le lien hébergé suffit généralement.

Les annulations désactivent la carte afin qu’elle ne puisse pas être scannée.

Pour la matrice complète des comportements, consultez Mises à jour, cycle de vie et statut d’installation.

Plus d’informations

Si vous avez encore besoin de configurer le contenu de la carte, allez à Modèle de Carte Wallet et correspondance des champs.

Si vous voulez valider les échanges, les annulations et le comportement de rafraîchissement, allez à Mises à jour, cycle de vie et statut d’installation.

Mis à jour il y a 1 mois