S-360 Documentation [fr]

Page tree

Versions Compared

Old Version 3

changes.mady.by.user LKL

Saved on

compared with

New Version Current

changes.mady.by.user LKL

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • 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é
Info

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
La description détaillée de ce service web est disponible ici: https://confluence.secutix.com/display/DOCEN/Catalog+API


Info

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

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