Intégration du site institutionnel

Concernant les intégrations avec le site institutionnel, la documentation technique de référence est la suivante:

https://platform.secutix.com

Et particulièrement cette page

https://platform.secutix.com/home/usecases/website

SecuTix met à disposition des interfaces qui permettent d’intégrer le site de vente en ligne au site web de l’organisation. Ces services inclus :

La remontée du catalogue de billetterie, afin d’éviter la saisie à double de ces informations dans la billetterie et dans le CMS

L’affichage dynamique des disponibilités sur un produit, un événement, une séance

L’implémentation d’un mécanisme de SSO (Single Sign On) entre la vente en ligne et le site web

La possibilité de lire et éditer certains attributs d’un contact générés par SecuTix

Architecture

En jaune, les éléments sous la responsabilité du client. En bleu, les composants SecuTix

Sur le site web, les pages suivantes doivent être hébergées :

Présentation du catalogue

- Thème et sous-thème
- Recherche
- Description détaillée, éléments multimédia

Accès à la vente en ligne

- Lien «Réserver» depuis la fiche produit

Pages statiques connexes à la vente en ligne

- Conditions générales de vente
- Sécurité et confidentialité
- Aide
- Nous contacter

Cycle de vie d’un événement

Les événement et autres produits sont configurés dans le site de vente en ligne SecuTix

Le catalogue est importé quotidiennement dans le CMS du site web

Le CMS permet d’enrichir ce contenu (description détaillée, éléments multimédia)

Le contenu est publié sur le site web

Le site web appelle le ticketshop pour rafraîchir les données de disponibilité

Processus de vente

L’internaute entre dans le site web

Il charge le catalogue, fait une recherche et sélectionne un événement

Si l’événement est en vente et n’est pas complet, l’internaute peut cliquer sur «réserver»

Il accède alors à la vente en ligne, où il choisit les billets souhaités (quantité, tarif)

S’il a déjà un compte, il doit juste s’authentifier. Sinon, il doit se créer un compte pour poursuivre son achat.

Il confirme sa commande et la règle par carte bancaire, bon cadeau ou solde d’avoir.

Webservices catalogue

1) Exporter le catalogue

L’export complet du catalogue est fait à travers les méthodes getCatalog et getCatalogueDetailed

Le catalogue contient les données suivantes : produits simples(identifiant, nom public, description, nombreux attributs) ; produits composés ; avantages ; grilles tarifaires ; calendrier par filière ; saison, activité ; classification ; vente croisée ; vitrine

La description détaillée de ce service web est disponible ici: https://confluence.secutix.com/display/DOCEN/Catalog+API

Recommandation : Un seul appel quotidien doit être fait pour l’export du catalogue.

2) Mettre à jour les disponibilités

La mise à jour des disponibilités est faite à travers la méthode getProductAvailability

L’indicateur de disponibilité est le suivant :

1 = vert, «disponible»

2 = orange, «bientôt complet, quelques places disponibles»

3 = rouge, «complet»

La description détaillée de ce service web est disponible ici : https://confluence.secutix.com/display/DOCEN/Availabilities+API

Webservices contact

1) Partage du nom / prénom

Une solution très simple permet de transmettre au site web les nom/prénom du contact si celui-ci est authentifié. L’identity provider (IDP) crée un cookie de domaine avec les nom/prénom du contact. Ce cookie rend cette information disponible pour le site web s’il est déployé sur le même domaine.

Ces données sont encodées au format url JSON.

Description complète : https://confluence.secutix.com/display/DOCEN/Contact+API

Domain

secutix.com or the client's

Key name

Contents

Description

stx_contact_<organisation code>_<channel code>_v1

A JSON object containing the following fields:

1.individualTitle

2.individualFirstname

3.individualLastname

4.nickname

5.lang

6.timestamp

7.additionalData

1.contactNumber

2.email

The timestamp field contains the date and time of the last login in the corresponding organisation.

The data in additionalData are encrypted. Please contact SecuTix for obtaining a decryption key. The encryption format is defined below.

2) SSO

Le mécanisme d’authentification unique repose sur le protocole SAML. L’IDP joue un double rôle : authentifier les utilisateurs et transmettre les identifiants de la personne authentifiée au site web. L’identification est déparée par point de vente internet SecuTix.

La base contact de SecuTix sert de source de référence des comptes utilisateurs. L’IDP utilise ces données pour valider l’adresse email et le mot de pass saisis par l’utilisateur. Conformément aux bonnes pratiques en matière de sécurité, SecuTix recommande d’utiliser exclusivement la page de login fournie par l’IDP.

Description complète : https://confluence.secutix.com/display/DOCEN/SSO+to+SecuTix

3) Créér ou modifier un contact

Pour des raisons de sécurité, les mots de passe ne transitent pas par le site web. Pour créer ou modifier un contact, le site web doit rediriger l’utilisateur vers une page du ticketshop.

La page standard de création de contact comprend 4 sections : accès au compte (login et mot de pase), profil (nom, prénom…), critères (centres d’intérêt), autorisations légales (CNIL). Le site web peut masquer certaines sections en utilisant les paramètres showAddress, showCriteria et showAuthorization.

Le site web doit aussi paramétrer une URL de retour vers laquelle le ticketshop va rediriger le contact après la création du compte.

Protocol	http
Method	GET
Domain	espaceclient.secutix.com
URI	/api/1/redirect/account/register	Creating a contact
URI	/api/1/redirect/account/edit	Editing a contact
Query string	Parameter name	Description
	callbackUrl	Return URL (encoding : application/x-www-form-urlencoded)
	lang	ISO 639-1 language code (optional)
	showAddress	Boolean: "true"/"false", "true" by default
	showCriteria	Boolean: "true"/"false", "true" by default
	showAuthorization	Boolean: "true"/"false" or 1/0, "true" by default

Liens du site web vers le ticketshop

SecuTix met à disposition une API auto-documentée. Un compte de démonstration est disponible ici : https://thecube-cube.demo-shop.secutix.com/api/1/ . Les méthodes les plus fréquentes sont décrites ci-dessous.

1) Bouton Réserver

Un lien réserver depuis la page du produit donne accès au site de vente en ligne. Ce lien ne doit être affiché que si le produit est en vente et disponible.

Exemple : https://demoresa.shop.secutix.com/api/1/redirect/product?id=1&lang=en

Protocol	https
Method	GET
Domain	*.shop.secutix.com
URI	/api/1/redirect/product
Query string	Parameter name	Description
	id	Product identifier
	code	Product code (if the Id is unknown)
	lang	ISO 639-1 language code (optional)

Il est aussi possible d’accéder directement à la séance d’un événement

Protocol	https
Method	GET
Domain	*.shop.secutix.com
URI	/api/1/redirect/product/performance
Query string	Parameter name	Description
	id	Identifier of the performance
	lang	ISO 639-1 language code (optional)

2) Accès à l’espace personnel

Il est possible d’accéder à l’espace personnel du client sur le ticketshop. Si le client n’est pas encore identifié, le ticketshop le redirigera vers la page d’authentification.

Protocol	https
Method	GET
Domain	espaceclient.secutix.com
URI	/api/1/redirect/account
Query string	Parameter name	Description
	lang	ISO 639-1 language code (optional)

3) Modification du profil

Il est possible d’accéder à la page de profil du client sur le ticketshop. Si le client n’est pas encore identifié, le ticketshop le redirigera vers la page d’authentification.

Protocol	https
Method	GET
Domain	espaceclient.secutix.com
URI	/api/1/redirect/account/edit
Query string	Parameter name	Description
	lang	ISO 639-1 language code (optional)

4) Afficher le panier d’achat sur le site web

A chaque modification du panier d’achat sur la filière de vente en ligne, le ticketshop écrit le nombre d’éléments et le montant total dans un cookie de domaine qui est lisible par le site web s’il est déployé dans le même domaine.

Protocol	COOKIE
Domain	secutix.com or the client's
Key name	Contents	Description
stx_cartSummary_<organisation code>_<channel code>	qty\|amount\|currency\|expiration\|orderId	Qty: number of articles in the cart Amount: total sum of the cart expressed in the purchasing currency, with a point ( . ) as decimal separator and no thousands separator. currency: currency code with the ISO-4217 format expiration: date when th current cart will be automatically abandoned orderId: technical identifier of this order

Liens du ticketshop vers le site web

1) Pages statiques

Le ticketshop SecuTix fait référence à du contenu éditorial statique au format HTML, dont les URL sont renseignées au niveau du point de vente internet. Plusieurs pages sont nécessaires :

conditions générales de vente

sécurité et confidentialité

aide

nous contacter

Depuis le ticketshop, les clients peuvent retourner vers la page de description d’un produit sur le site web. L’URL est configurée au niveau du produit dans SecuTix.

2) Changement de langue

Si le client modifie sa langue sur le ticketshop, il est nécessaire que le lien inclue un élément spécifiant le langage courant afin que ce changement soit visible sur le site web. Si la mention {LANGUAGE} est présente dans une URL externe configurée au niveau du point de vente, cette chaîne de caractères sera remplacée par le code ISO 639-1 de cette langue. Ceci est valable pour l’ensemble des liens vers le site web. Par exemple : http://www.mysite.com/{LANGUAGE}/index.html devient http://www.mysite.com/fr/index.html si l’utilisateur navigue sur la version française.