💡 L'article suivant explique en détail le fonctionnement des intégrations techniques proposées par le pass Culture : Intégrations techniques.
📢 Une clé API (ou token) se crée au niveau d'une structure (et non d'un lieu). La clé API est donc valable pour tous les lieux qui partagent un même SIREN
Par exemple : 123 456 789 00001 et 123 456 789 00002 pourront utiliser la même clé API, générée pour la structure de SIREN 123 456 789
🚩 Lors d'une réservation, le bénéficiaire du pass Culture reçoit un mail avec un QR code associé à un numéro de contremarque. Pour la valider, vous avez deux options :
- Rentrer manuellement le numéro de contremarque dans l'onglet "Guichet" et cliquer sur valider
ou - Scanner le QR code de réservation, en connectant votre douchette/matériel de caisse avec le pass Culture. Ce système vous permettra de gagner du temps lors du passage en caisse des jeunes et facilitera la validation instantanée des contremarques
Quelles démarches techniques dois-je effectuer pour connecter ma douchette au pass Culture Pro ?
👉 Première étape : générer une clé API
Vous devez générer ce que l'on appelle une "clé API" sur votre espace pass Culture, qui permettra ensuite la transmission entre votre matériel de caisse et la lecture des QR code de réservations. Cette clé API se crée au niveau de votre structure (et non de votre lieu). Cette clé est unique et sera utilisable pour tous les lieux rattachés à votre structure. Vous n'aurez pas besoin de générer une clé API par lieu.
- Depuis l'espace pro, cliquez sur "Modifier" sur la partie de votre structure :

- Allez dans la section "Gestion des clés API" (plus bas dans la page)
- Cliquez sur le bouton "Générer une clé API" : en cliquant sur le bouton "Copier", la clé api sera automatiquement copiée dans votre presse-papier. Au cas où le bouton "Copier" ne fonctionne pas ou renvoie une erreur : vous pouvez aussi surligner la clé en entier et faire clic droit → Copier

📢 Pensez bien à copier immédiatement cette clé et stockez-la dans un endroit sûr où vous pourrez la visualiser entièrement. Vous ne devez générer qu'une seule clé API, valable pour tous vos lieux. Le pass Culture vous permet de générer jusqu'à 5 clés API différentes, uniquement au cas où vous auriez perdu votre numéro de clé ou en cas de dysfonctionnement.
👉 Deuxième étape : transmettre la clé API à votre prestataire de matériel de caisse
💡 Lorsque votre clé API aura été générée sur votre espace pass Culture pro, il vous faudra ensuite contacter votre prestataire de caisse pour lui transmettre l'intégralité de ce numéro de clé. Cela lui permettra d'effectuer la transmission avec votre douchette. Votre prestataire vous expliquera ensuite les démarches restantes pour que la connexion soit efficiente.
Tester la bonne transmission et la lecture des QR codes
💡 Une fois l'intégration technique effectuée, sachez que vous pourrez tester la validation d'un QR code avec votre douchette en utilisant la réservation ci-dessous :
👉 Vous pourrez ensuite scanner les QR codes des jeunes pour valider leurs réservations, sans avoir à saisir les numéros de contremarques correspondants dans le guichet
🔎 Si vous souhaitez en savoir plus, l'article suivant explique en détail le fonctionnement des intégrations techniques proposées par le pass Culture : Intégrations techniques.
Articles connexes :
Pour toute information complémentaire, n'hésitez pas à écrire au support :
📍 support-pro@passculture.app