Introduction

This document aims to provide a comprehensive description of the features and functionality of the connector between Neostore and the Secutix ticketing software. The connector is designed to digitize event tickets and make them accessible via clients’ mobile wallet applications, such as Apple Wallet and Google Wallet. It allows for seamless integration between Secutix ticket data and Neostore pass templates.

📌 More informations on https://www.secutix.com/fr

Activate Secutix connector

• QA: https://admin-qa.neostore.cloud/tenant/~/configuration
• PROD: https://admin.neostore.cloud/tenant/~/configuration

Integrations ⇒ Secutix

connection:
  url: https://xxxxx.ws.secutix.com
  operator: xxxx
  institution: xxxx
  partner: Neostore
  secret: XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
pass:
  defaultPassType: XXXXX (From Neostore)

Designing Wallet Ticket Templates for Secutix

The connector enables the design of Neostore pass templates using data extracted from Secutix tickets. These templates include all relevant information about the event, ticket, seating, and ticket holder details.

Create a Pass Template

• Name: Define the name of your pass template. Will be used by secutix to use the right template if SDK is deployed on the ticketshop.
• Select Type: Event Ticket
• Pass Layout: Select the default pass layout page that will be used to enroll users in Wallets

Configure a Pass Template

Here are the available data fields:

Ticket Distribution in Mobile Wallet Applications

Link, pages, SDK to enroll users in mobiles Wallets applications.

New Neostore Page for Downloading Tickets into Wallets

• Create a new layout page: tickets

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

Responsive and adaptive web page. Displays a QR code in desktop mode and the Apple Wallet button on iOS devices and the Google Wallet button on Android devices.

It enables users to:

• List all tickets from an order
• Option to define 2 lines of text to differentiate tickets
• Download multiple tickets at once
• Download tickets from different templates

This page can be linked in a Secutix transactional email following the order.

• Link to a ticket
• Link to tickets from an order

SDK in the Ticket Shop

This feature is accessible from the Secutix ticket shop page, where all tickets purchased by a buyer are aggregated.

The connector is equipped with an integrated Neostore SDK, allowing for the direct distribution of tickets into users’ mobile wallet applications.

You can copy the code snippet directly from the secutix integration page within neostore here:

Automatic Ticket Updates

A key feature of the connector is its ability to automatically update tickets in the passes based on various business scenarios managed by Secutix.

For example, in case of a ticket cancellation, exchange, or modification, the connector can synchronize these changes and update the corresponding passes in the users’ mobile wallet applications.

• Ticket updates when an order is updated in Secutix.

Exemple of Webhook

{
  "ticketId":10229206115606,
  "saleMovementId":10229206116627,
  "orderSecretToken":"e49638c0-899f-43af-8a7f-c7e123f81de5_2390017",
  "STATE":"NOT_PRINTED",
  "lastUpdate":"2024-04-03 08:58:44"
}

Provide a neostore url to Secutix.

This url will should be configured in Secutix and will listen webhooks:

/api/{tenantId}/webhooks/listeners/secutix/orders

Find below a list of use cases:

This table translates the operations and their availability or actions taken in different contexts, such as in the ticketshop, back office, or regarding ticket management actions like reprinting, exchanging, or cancelling.

This feature ensures an up-to-date and hassle-free user experience.

Geolocated Notifications

It’s possible to set up geolocated notifications to display a message on iOS users’ phones when they are near the event venue.

• The distance can be configured from the Neostore administration console.

Apple Wallet General ⇒ Max Distance 300 meters

Statistics

List of Passes: https://admin.neostore.cloud/tenant/~/passes

It’s possible to access statistics on the adoption and usage of wallet tickets split by events from Secutix.