En jaune, les éléments sous la responsabilité du client. En bleu, les composants SecuTix
- 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é
En cas d’utilisation du CMS Drupal, SecuTix dispose d’un ensemble d’outils qui facilite des données de billetterie. |
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
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 :
- 2 = orange, «bientôt complet, quelques places disponibles»
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.
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.
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 |
/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é
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.