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

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éer un profil 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 »

02. Créer un contact Pass Culture

Ce contact sera le cont 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 correspondances pour :

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.