Informations générales
PassCulture est un programme mis en place par le gouvernement français pour faciliter l'accès à la culture des jeunes en France. Grâce à un crédit qui leur est attribué, les jeunes peuvent profiter d’une offre culturelle large (expositions, spectacles, ateliers, concerts, livres, etc.) en utilisant ce crédit via une application mobile.
Vous pouvez désormais faciliter la mise à disposition de vos offres en activant notre nouvelle interface qui publiera vos événements / visites sur l’application et fera remonter toute réservation réalisée via Pass Culture dans votre back-office.
ATTENTION L’interface Pass Culture ne supporte actuellement que l’offre à destination du public individuel (uniquement les familles de produit ÉVÉNEMENTS et PASS VISITES). |
|---|
00. Prérequis
Ouvrir un ticket sur le portail client (https://customerportal.secutix.com/) afin que notre équipe support active l’interface Pass Culture dans votre back-office et renseigne les informations nécessaires à la connexion (URL du service / Clé API / Clé de signature HMAC).
01. Créer une filière de vente qui supportera l’interface
00. [OPTIONNEL] Créer un contingent dédié aux places / billets que vous souhaitez mettre à disposition sur l’application Pass Culture. Vous pourrez également rattacher un contingent de vente global.
01. Dans le contexte Institution > Initialisation, créer une nouvelle filière de vente de type Interface en temps réel
02. Vérifier qu’un contingent est associé (aucun contingent dédié n’est requis, vous pouvez ajouter « Hors contingent »)
03. Dans le contexte Organisme > Initialisation > Filières de vente, activer la filière tout juste créée, puis créer un point de vente associé. Associer le mode de paiement « compte en attente ».
04. Activer la filière de vente et le point de vente
05. Mettre des produits (uniquement événements ou pass visites) en vente sur ce canal
Créerprofil d’activité pour les événements en associant la filière « Pass Culture »
Créer un profil produit pour les pass visites en associant la filière « Pass Culture »
ATTENTION vous ne pouvez pas ajouter plus de 2 tarifs et 5 catégories différentes pour les événements. |
|---|
02. Créer un contact Pass Culture
Ce contact sera le contact d’achat unique de toutes les commandes Pass Culture qui remonteront dans votre back-office.
Vous devez donc créer une fiche qui doit :
être de type structure
posséder une adresse email définie (peu importe la valeur, ex. : noreply@passculture.app)
avoir accès au paiement en compte d’attente (dans l’onglet « Gestion » de la fiche, passez la valeur de l'élément « compte d’attente » à « oui »)
Important : noter le numéro de ce nouveau contact, il sera utilisé dans la configuration de l’interface.
03. Créer l’interface
01. Dans le contexte Organisme > Outils > Liste des interfaces, créer une interface « revendeur » et de type « Pass Culture ».
02. Saisir l’URL fournie par Pass Culture (voir 00. Prérequis)
03. Connexion : laisser le champ vide
04. Mot de passe : saisir la clé API Pass Culture (voir 00. Prérequis)
05. Clé API pour appels REST : générer un mot de passe avec une chaîne aléatoire de 20 caractères alphanumériques (utiliser un outil comme KeePass ou )
06. Opérateur virtuel pour les appels REST : respecter le modèle CodeVotreInstitution_CodeFilièrePassCulture
exemple :
MUROMA_PASSCUL
07. HMAC pour REST auth : clé transmise par Pass Culture (voir 00. Prérequis)
08. Contact : numéro du contact créé à l’étape 2
09 et 10. Filière de vente et Point de vente : code de la filière et du point de vente Pass Culture créée à l’étape 1
11. Caractéristiques du produit : activer au besoin les 4 caractéristiques accessibilité des produits qui seront publiées sur la plateforme et activer ou non la possibilité pour un contact de réserver pour 2 personnes (« réservation duo »)
12. Offerer SIREN : numéro SIREN de l’institution (tel qu’il apparaît sur la plateforme Pass Culture, dans l’espace pro de l’institution)
04. Créer un mapping
Dans l’onglet « Correspondance » de l’interface, créer des
01. les sites : si vous proposez des produits sur plusieurs sites, il faut créer des correspondances pour qu’ils soient tous rattachés à la même institution dans Pass Culture.
02. les produits que vous proposez, afin qu'ils soient tous rattachés à la bonne catégorie dans Pass Culture
XXX ILLU XXX
05. Lancer la publication des offres
Dans l’interface, dans le menu de gauche “Programmation”, créer un nouveau batch de type “Publier les offres” et planifier une exécution automatique toutes les 15 minutes. Cliquer sur “programmation” pour planifier la publication.
Il est également possible d’exécuter manuellement la tâche afin de vérifier dans les journaux qu'il n'y a pas d'erreurs et que les produits à publier ont bien été synchronisés avec l’application Pass Culture.
AIDE Si les produits ne remontent pas sur l’application Pass Culture, penser à vérifier :
|
|---|
Une fois synchronisés, les produits apparaissent dans le back-office (accès professionnels) et dans l’application Pass Culture (plateforme publique).
Une fois les produits / événements publiés, chaque personne disposant d’un compte Pass Culture et d’un portefeuille crédité pourra réserver vos offres.
07. Enregistrer les URL callbacks
Les callbacks vont permettre à Pass Culture d’appeler S-360 afin de créer ou d’annuler une commande dans le back-office. Actuellement, il est nécessaire de demander à votre CSM ou faire une demande de service pour opérer cet enregistrement, mais cette manipulation pourra être prochainement automatisée dans une prochaine version de l’interface.
08. Processus d’achat