Distribution
Livrez les billets Aparté à Apple Wallet et Google Wallet depuis des parcours e-mail ou des pages web propriétaires.
Pourquoi la distribution est importante
Un ticket Wallet n’est utile que si le point d’entrée est facile à ouvrir et fiable. La distribution Aparté commence généralement juste après l’achat, sur la page de confirmation, dans l’e-mail de confirmation, ou plus tard depuis une page de compte.
The Wallet Crew prend en charge deux schémas pratiques. Un schéma utilise des pages de billets hébergées. L’autre utilise le SDK sur un site Web contrôlé par la marque ou le partenaire.
Envoyer les billets depuis un e-mail
L’e-mail est le canal de distribution Aparté le plus courant. Il fonctionne bien lorsque le parcours de billetterie envoie déjà un e-mail d’achat ou de rappel.
The Wallet Crew propose des pages hébergées qui détectent l’appareil et ouvrent le bon parcours Wallet. Sur mobile, la page affiche l’action native Apple Wallet ou Google Wallet. Sur ordinateur, elle revient à un code QR.
Utilisez toujours un domaine personnalisé pour ces liens. Cela garde visible la marque de l’organisateur et évite d’exposer aux clients un domaine générique The Wallet Crew.
Pour le modèle complet par e-mail, voir Par e-mail.
Lier plusieurs billets
Utilisez la page hébergée billets page lorsqu’un seul élément de commande Aparté correspond à plusieurs billets.
https://<customdomain>/<tenantId>/tickets?ids.aparte.orderItemId=<orderItemId>&ids.aparte.orderItemId.hmac=<hmac>ids.aparte.orderItemId est l’identifiant multi-billets. Le HMAC correspondant signe exactement cette valeur.
Cette page liste chaque billet résolu à partir de cet élément de commande Aparté. C’est le point d’entrée standard pour un parcours de confirmation de commande lorsque plusieurs billets doivent être affichés à partir d’un seul parcours de réservation.
Un exemple QA suit la même structure :
Lier un seul billet
Utilisez la page hébergée billet page lorsque le parcours doit ouvrir directement un billet précis.
id.aparte.ticketId est l’identifiant d’un seul billet. Sa valeur est <orderItemId>|<seatId>.
Encoder le séparateur en %7C est plus sûr que de laisser un | brut dans l’URL. Le HMAC doit correspondre à la valeur exacte utilisée dans le lien.
Un exemple QA suit le même modèle :
Notes d’implémentation pour l’e-mail
Trois règles comptent pour la fiabilité. Calculez le HMAC côté serveur. Utilisez toujours un domaine personnalisé configuré, pas localhost. Conservez l’URL complète dans l’outil d’e-mail afin qu’aucun paramètre de requête ne soit tronqué ou réécrit.
Ajoutez le bouton sur un site Web avec le SDK
Utilisez le SDK lorsque la marque ou le partenaire contrôle la page où le billet est affiché. Les emplacements typiques sont une page de confirmation de commande, un compte client ou une liste de billets dédiée.
Le SDK gère la détection de l’appareil et affiche la bonne action Wallet. La partie spécifique à Aparté est le contrat d’identifiant envoyé au SDK.
Pour le modèle complet d’intégration sur site Web, voir Sur votre site web.
Modèle SDK pour billet unique
Pour un billet, la page doit résoudre l’identifiant Aparté dans le même format que l’URL hébergée pour un seul billet.
Utilisez aparte.ticketId comme identifiant externe. Sa valeur est <orderItemId>|<seatId>. Le HMAC correspondant doit être généré côté serveur à partir de cette valeur exacte.
C’est le modèle à utiliser lorsqu’un seul bouton Wallet est affiché pour une carte de billet ou une ligne de billet.
Modèle de site Web pour plusieurs billets
Pour une page qui affiche plusieurs billets, deux modèles fonctionnent bien.
Le premier modèle affiche un bouton SDK par billet. C’est utile sur une page Mes billets authentifiée. Mes billets page.
Le deuxième modèle renvoie vers la page hébergée /tickets en utilisant ids.aparte.orderItemId. C’est généralement plus simple sur une page de confirmation, car un seul lien peut exposer la liste complète des billets résolus à partir de l’élément de commande.
Notes de sécurité
La distribution Aparté repose sur des identifiants signés. Le HMAC doit rester côté serveur et ne doit jamais être généré dans le code du navigateur.
La valeur de l’identifiant et la valeur signée doivent rester identiques. Si l’identifiant du billet est signé en tant que <orderItemId>|<seatId>, l’URL distribuée doit réutiliser cette valeur exacte. Si le pipe est encodé dans l’URL dans le lien final, le HMAC signe toujours la valeur logique de l’identifiant, et non un identifiant de billet différent.
FAQ
Mis à jour