UiTPAS et tarif solidaire dans votre billetterie

Avec l'UiTPAS, une personne à faibles revenus peut venir à votre activité à un prix fortement réduit, et la commune met une partie au pot. Cet article explique ce qu'est l'UiTPAS, comment votre organisation y adhère, comment préparer la connexion dans Passavo, et ce qui se passe exactement quand un visiteur tape son numéro de pass.

Qu'est-ce que l'UiTPAS

L'UiTPAS est une carte d'épargne et d'avantages pour les activités de loisirs dans les villes et communes flamandes. Elle est gérée par publiq vzw. Un habitant d'une commune UiTPAS peut obtenir la carte gratuitement ou pour un petit prix et l'utilise à la maison de la culture, au club sportif, à la bibliothèque ou au musée.

La carte fait deux choses.

1. Épargner des points. À chaque visite, le titulaire épargne des points, qu'il peut échanger contre un avantage : une boisson, une réduction, un billet gratuit.
2. Le tarif solidaire. Qui a droit dans sa commune à une intervention majorée obtient discrètement un tarif fortement réduit sur les activités UiTPAS de sa propre région UiTPAS.

C'est ce second point qui fait l'objet de cet article, car de l'argent y est lié qui ne vient pas du visiteur.

Comment le tarif solidaire est payé

Le principe de l'UiTPAS est que le visiteur au tarif solidaire paie 20 pour cent du prix du billet. Les 80 pour cent restants sont partagés : 40 pour cent pour vous comme organisateur et 40 pour cent pour le pouvoir local. Vous supportez donc vous-même une partie de la réduction, et vous récupérez la part de la commune.

Attention : c'est le principe général de l'UiTPAS. Les régions et les communes peuvent convenir d'autres accords sur les pourcentages, le remboursement et les activités qui participent. Vérifiez donc toujours ce qui vaut pour votre région avant de régler quoi que ce soit.

C'est la commune, et non vous, qui décide qui a droit au tarif solidaire. Au guichet, vous n'avez même pas à le demander : le pass le dit lui-même, et c'est fait exprès, pour que personne ne doive expliquer à un guichet qu'il n'a pas les moyens.

Comment votre organisation adhère

Passavo ne peut agir que lorsque vous êtes enregistré chez publiq comme organisateur UiTPAS. Cela se règle en dehors de ce système.

1. Vérifiez si votre commune est une commune UiTPAS. Vous trouvez les régions sur uitpas.be. Si votre commune n'en fait pas partie, vous ne pouvez pas encore proposer l'UiTPAS ; l'initiative revient alors au pouvoir local, qui peut rejoindre une région UiTPAS voisine.
2. Prenez contact avec l'organisation UiTPAS de votre région. C'est la voie que publiq indique lui-même aux prestataires d'une commune qui participe déjà. Le plus souvent, il s'agit du service loisirs ou culture de votre ville ou commune.
3. Fixez les accords. Quelles activités participent, quel tarif s'applique, comment et quand la part de la commune est remboursée.
4. Encodez vos activités dans l'UiTdatabank. Chaque activité y reçoit son propre event-id, et vous avez besoin de cet id par produit. Votre organisation y figure aussi, avec son propre id : c'est votre organizer-id.

Attention : les accords avec votre région diffèrent d'une commune à l'autre. Certaines régions travaillent avec un formulaire de demande propre, d'autres avec un entretien et une convention. Commencez donc toujours par votre propre commune ou par publiq via publiq.be ou uitpas.be, et non par nous. Nous ne pouvons pas vous faire reconnaître comme prestataire UiTPAS ; c'est votre région qui en décide.

Demander vos clés API à publiq

Une fois prestataire UiTPAS, vous demandez vous-même à publiq les clés avec lesquelles Passavo peut dialoguer avec l'UiTPAS en votre nom. C'est gratuit et cela prend environ un quart d'heure. Vous n'avez pas besoin de clés de test : vous demandez directement les vraies clés.

1. Connectez-vous à publiq platform. Ouvrez platform.publiq.be et connectez-vous avec votre UiTiD, ou créez un compte. Le lien ouvre directement le formulaire d'une nouvelle intégration UiTPAS. La plateforme est en néerlandais ; les libellés sont repris ci-dessous tels qu'ils y apparaissent.

2. Choisissez le type « UiTPAS API ». Cette intégration est gratuite.

3. Remplissez le formulaire :

   • Nom : le nom de votre organisation ;
   • Site web : l'adresse de votre site ou de votre billetterie, précédée de https:// ;
   • Objectif : par exemple « Relier notre boutique en ligne et nos ventes au guichet via Passavo à l'UiTPAS, afin que le tarif solidaire soit vérifié et enregistré automatiquement. » ;
   • Personne de contact de l'organisation : la personne responsable chez vous de la billetterie ou de l'UiTPAS ;
   • Contact technique : Passavo, avec l'adresse [email protected]. Ainsi, publiq peut nous joindre directement pour une question technique.

   Enregistrez le formulaire. L'intégration est maintenant créée.

4. Ignorez les clés de test et cliquez sur « Activatie aanvragen » (demander l'activation). Publiq vous montre d'abord des clés de test ; vous n'en avez pas besoin. Dans le formulaire d'activation :

   • indiquez Passavo comme partenaire (celui qui fournit la connexion sur le plan technique), avec le nom et l'adresse de la société derrière Passavo. Vous trouvez ces données dans nos mentions légales ;
   • énumérez toutes les organisations UiTdatabank pour lesquelles des billets doivent être enregistrés. Si plusieurs salles ou asbl ayant leur propre organisation dans l'UiTdatabank vendent des billets par votre intermédiaire, ajoutez-les toutes.

   Envoyez la demande.

5. Attendez l'e-mail de publiq. Dans un délai de quelques jours ouvrables, vous recevez le client-id live et le client secret. Toujours rien après une semaine ? Contactez alors publiq en précisant qu'il s'agit de clés API pour une connexion UiTPAS via Passavo.

6. Saisissez les clés dans Passavo, comme décrit à l'Étape 1 ci-dessous.

Bon à savoir : Passavo est un nouveau partenaire chez publiq. Pour les premières demandes qui mentionnent Passavo comme partenaire, l'activation peut donc prendre un peu plus de temps que d'habitude. Si vous n'avez pas de nouvelles après une semaine, prévenez-nous aussi via [email protected] : nous assurerons le suivi auprès de publiq.

Où trouver votre organizer-id

L'e-mail de publiq contient le client-id et le secret, mais pas votre organizer-id. Celui-ci se trouve dans l'UiTdatabank :

1. Connectez-vous à uitdatabank.be avec le même UiTiD.
2. Ouvrez la page de votre organisation, la même que celle que vous avez indiquée dans la demande d'activation.
3. L'organizer-id est le long code avec des tirets dans la barre d'adresse (de la forme 1a2b3c4d-…). Copiez-le en entier.

Si plusieurs organisations de votre liste vendent des billets via Passavo, chacune a sa propre organisation dans Passavo et chacune y indique son propre organizer-id. Vous utilisez alors chez chacune les clés reçues par e-mail de publiq.

Ce dont vous avez besoin au préalable

• Le rôle Propriétaire : lui seul peut configurer les pass externes.
• Votre organizer-id UiTPAS, issu de l'UiTdatabank.
• Le client-id live et le client secret reçus par e-mail de publiq après votre demande d'activation. Les clés de test ne fonctionnent pas.
• Des produits de type Événement ou Série : ce n'est que là que vous pouvez indiquer un identifiant d’événement UiTPAS.
• Par produit participant : l'event-id UiTPAS.
• Un quart d'heure pour demander les clés, quelques jours ouvrables avant que publiq ne les envoie, puis encore un quart d'heure pour tout saisir dans Passavo.

Deux choses qui diffèrent d'une réduction ordinaire

1. C'est l'api de publiq qui décide du droit, pas nous. Passavo ne calcule aucun tarif lui-même et ne retient pas qui a droit. Qui a droit aujourd'hui peut ne plus l'avoir demain, et un « oui » mémorisé, c'est une commune qui paie pour quelqu'un sans droit.
2. Une annulation doit aussi arriver chez publiq. Une vente de billet qui y reste alors que le billet a été annulé chez nous compte dans le décompte — et cela ne se remarque qu'un an plus tard.

Étape 1 — Préparer la connexion

1. Dans le menu de gauche, sous le titre Paramètres, cliquez sur Pass externes. Vous ne voyez pas ce point de menu ? Alors vous n'avez pas le rôle Propriétaire ; demandez-le à la personne qui a créé l'organisation.
2. Activez Nous acceptons l'UiTPAS avec tarif solidaire.
3. Indiquez votre Organizer-id UiTPAS. Vous le trouvez dans l'UiTdatabank, auprès de votre organisation (voir Où trouver votre organizer-id ci-dessus).
4. Indiquez votre Client-id et votre Client secret : les clés live de l'e-mail de publiq, pas les clés de test. Voyez-les comme le nom d'utilisateur et le mot de passe avec lesquels Passavo peut frapper chez publiq en votre nom.
5. Cliquez sur Enregistrer.
6. Cliquez ensuite sur Tester la connexion. Le test utilise ce qui a été enregistré ; si vous testez avant d'enregistrer, vous testez les anciennes données.

Les clés sont conservées chiffrées. Si vous enregistrez plus tard à nouveau avec le champ secret vide, la clé existante demeure. Sinon, chaque modification effacerait une clé que plus personne ne peut retaper.

Le test demande à publiq pour quels organisateurs vos clés sont valables, et si vous pouvez demander des tarifs et enregistrer des ventes de billets pour votre organizer-id. Si cela fonctionne, vous voyez le nom de votre organisateur tel que publiq le connaît. S'il manque un droit, le message indique lequel.

Vous voyez le message « La connexion UiTPAS n’est pas encore activée sur cette plateforme » à la place des champs ? Ce n'est pas un réglage de votre côté : Passavo doit activer la connexion une fois pour cette installation. Envoyez un mot au support et nous le faisons pour vous.

Étape 2 — Indiquer l'event-id par produit

Indiquez sur chaque produit qui participe à l'UiTPAS l'event-id UiTPAS. Cet id correspond à l'activité telle qu'elle est enregistrée chez publiq. Le champ n'existe que sur les produits de type Événement ou Série ; un simple billet d'entrée ou un billet avec créneau ne peut donc pas bénéficier du tarif solidaire.

Où se trouve ce champ :

1. Dans le menu de gauche, sous Vente, cliquez sur Événements et ouvrez le produit.
2. Faites défiler jusqu'au bloc L'événement. Vous y trouvez le champ Identifiant d’événement UiTPAS (il n'apparaît que lorsque la connexion est activée sur la plateforme).
3. Collez-y l'id de l'événement dans l'UiTdatabank (le long code dans la barre d'adresse quand vous y ouvrez l'événement, ou l'id que publiq vous a communiqué) et cliquez sur Sauvegarder les modifications.

Publiq calcule par événement et non par organisation. Sans cet id, aucun tarif ne peut donc être calculé : le visiteur voit alors Ce pass ne donne aucune réduction sur le contenu de votre panier et paie le prix plein. Si quelque chose ne va pas, c'est la première chose à vérifier.

Étape 3 — Utiliser un pass, dans la boutique et au guichet

Il y a un seul champ de saisie pour tous les pass : dans la boutique, le champ Numéro de pass sous Vous avez un UiTPAS ou un museumPASS ?, au guichet le champ UiTPAS ou museumPASS, chaque fois avec le bouton Appliquer. Le visiteur ou votre collaborateur au guichet recopie le numéro ; à la forme de ce numéro, Passavo voit tout seul s'il s'agit d'un UiTPAS (treize chiffres) ou d'un autre pass.

Ce qui se passe alors :

1. le numéro de pass part vers publiq ;
2. publiq dit s'il y a droit au tarif solidaire ;
3. s'il y a droit, le prix d'un billet est réduit ;
4. juste avant le paiement, la vente du billet est enregistrée chez publiq ; si le paiement échoue, cet enregistrement est retiré.

Au guichet, cela fonctionne exactement de la même manière : un champ, un numéro, une touche. Voir Guichet et caisse.

Un pass vaut pour une personne

S'il y a une ligne de trois billets, elle est scindée : un billet au tarif solidaire et deux au prix ordinaire. Qui réduirait toute la ligne fait intervenir la commune trois fois pour une seule carte.

Si une famille arrive avec deux pass, ajoutez-les un par un. Chaque pass réduit un billet.

L'enregistrement a lieu juste avant le paiement

C'est ce que publiq prescrit : ce n'est qu'une fois la vente enregistrée chez publiq qu'il est certain que le tarif solidaire peut être accordé. C'est pourquoi Passavo enregistre la vente au moment où le visiteur clique sur Payer (ou, au guichet, sur un bouton de paiement), avant que l'argent ne soit encaissé.

• Si publiq refuse malgré tout à ce moment-là — parce que le maximum hebdomadaire a entre-temps été atteint à un autre guichet, par exemple — la réduction est retirée de la commande et le visiteur voit l'explication de publiq. Il paie alors le prix normal, ou abandonne ; personne ne paie un montant réduit qui ne vous sera jamais remboursé.
• Si le paiement échoue ou si le visiteur abandonne, Passavo retire l'enregistrement chez publiq. De l'argent qui n'arrive jamais ne doit pas laisser de tarif solidaire dans le décompte d'une commune.

Ce qu'un visiteur voit

Message	Ce qui se passe	Ce que vous faites
Tarif solidaire appliqué : vous payez … au lieu de …	Le droit existe ; le prix d'un billet est réduit	Encaisser
Cet UiTPAS n'a pour l'instant pas droit au tarif solidaire	Le pass existe, mais le statut solidaire n'est pas actif	Prix ordinaire. Pour les questions, renvoyez vers la commune
Het UiTPAS-nummer dat je invulde konden we niet terugvinden. Kijk je het nummer even na? (texte de publiq, en néerlandais)	Publiq ne connaît pas ce numéro	Faites vérifier le numéro ; un chiffre erroné arrive vite
Une autre explication de publiq, p. ex. Je kansenstatuut is vervallen…, Oeps, jouw UiTPAS is niet meer geldig… ou Je kan maximaal 1 ticket per week kopen aan kansentarief…	Publiq refuse le tarif solidaire et explique lui-même pourquoi. Nous affichons ce texte tel quel, comme publiq le demande	Prix normal. Renvoyez les questions au guichet UiTPAS ou à la commune
Ce pass ne donne aucune réduction sur le contenu de votre panier	Le droit existe, mais aucun des produits n'a d'identifiant d’événement UiTPAS (ou publiq ne donne pas de tarif pour cet événement)	Vérifiez l'event-id sur le produit
Nous ne reconnaissons pas ce numéro de pass	Le numéro n'a pas la forme d'un pass que vous acceptez	Faites vérifier le numéro
L'UiTPAS n'a pas pu être vérifié	Une panne chez publiq	Réessayez plus tard, ou encaissez au prix ordinaire

Cette dernière distinction est voulue : un visiteur doit savoir s'il n'a pas droit ou si le système ne coopère pas un instant. Ce sont deux conversations très différentes, et la première n'est pas de celles que les gens aiment tenir dans un hall d'entrée bondé.

Annuler et rembourser

Si vous remboursez une commande via votre prestataire de paiement, Passavo retire automatiquement la vente du billet chez publiq dès que le remboursement est confirmé. Vous n'avez rien à faire pour cela. Attention : cela vaut pour tous les pass de cette commande, même en cas de remboursement partiel.

Si vous annulez seulement un billet, sans remboursement, l'enregistrement reste chez publiq. C'est aussi le cas pour une vente en espèces au guichet que vous remboursez depuis le tiroir-caisse. Signalez alors vous-même ce cas à votre personne de contact UiTPAS, pour qu'il ne reste pas dans le décompte de votre commune.

Si cela échoue — publiq est hors service, le réseau flanche — la commande reste simplement annulée. L'enregistrement demeure visible pour qu'il puisse être présenté à nouveau. Un message qui échoue vers publiq ne doit jamais bloquer votre propre annulation : le visiteur est devant vous et veut son argent.

Erreurs fréquentes

Fixer soi-même le tarif solidaire comme prix. Ne le faites pas. Le montant vient de publiq, par événement. Si vous le fixez vous-même, le décompte avec votre commune ne colle plus.

Oublier l'event-id sur un nouveau produit. Le pass est alors bien reconnu, mais le visiteur voit Ce pass ne donne aucune réduction sur le contenu de votre panier. C'est de loin la cause la plus souvent signalée.

Utiliser un seul pass pour toute une famille. Un pass réduit un billet. Si une famille arrive avec plusieurs pass, ajoutez-les un par un.

Demander qui a droit au tarif solidaire. À ne pas faire. Le pass le dit lui-même, et le tarif doit rester discret.

Dire « pas de droit » lors d'une panne. Lisez le message. « N'a pas pu être vérifié » signifie que publiq est momentanément injoignable, pas que le visiteur n'a pas droit.

Et si …

… ma commune n'est pas une commune UiTPAS ?

Alors vous ne pouvez pas encore proposer l'UiTPAS. Une commune peut rejoindre une région UiTPAS voisine ; cette conversation, vous la menez avec votre échevin ou avec le service loisirs. Publiq accompagne les communes dans cette démarche.

… le test de la connexion donne une erreur ?

Vérifiez d'abord votre organizer-id, votre client-id et votre secret — un espace copié par mégarde est le grand classique. Avez-vous saisi les clés de test que publiq affiche juste après la création de l'intégration ? Elles ne fonctionnent pas : Passavo dialogue avec le véritable environnement UiTPAS. Saisissez les clés live de l'e-mail d'activation. Si l'erreur persiste, prenez contact avec publiq ou avec votre région : il se peut que l'activation ne soit pas encore finalisée.

… un visiteur n'a pas son pass sur lui ?

Alors il n'y a pas de numéro et donc pas de tarif solidaire. Vous ne pouvez pas rechercher le numéro ; Passavo ne tient aucune liste de pass, et c'est voulu.

… le prix ne change pas alors que le pass est reconnu ?

Presque toujours, l'event-id manque sur ce produit, ou c'est l'id d'une autre activité. Vérifiez cela en premier. Si le produit n'est pas un Événement ou une Série, il ne peut pas bénéficier du tarif solidaire.

… publiq est hors service pendant un moment de forte affluence ?

Encaissez au prix ordinaire et renvoyez le visiteur vers la commune pour le remboursement, ou demandez-lui de revenir plus tard. Ne fixez jamais un prix plus bas à la main : cette vente ne se retrouve alors pas dans le décompte chez publiq et votre commune ne paie rien pour elle.

Questions fréquentes

Dois-je fixer moi-même le tarif solidaire ? Non. Le montant vient de publiq, par événement. Si vous le fixez vous-même, le décompte avec votre commune ne colle plus.

Cela fonctionne-t-il aussi au guichet ? Oui, exactement de la même manière : un champ, un numéro, une touche.

Où puis-je voir ce qui a été enregistré ? Sur la commande, le tarif appliqué figure sur la ligne. Ce qui est parti vers publiq, Passavo le conserve par utilisation avec la référence que publiq a renvoyée ; le panneau n'en propose pas d'aperçu séparé.

Le tarif solidaire me coûte-t-il de l'argent ? Oui, une partie. Le principe de l'UiTPAS est que vous, en tant qu'organisateur, supportez une partie de la réduction et que la commune en prend une partie à sa charge. Ce qui est convenu exactement pour votre région, vous l'apprendrez auprès de votre commune.

Puis-je voir qui a droit, sans que le visiteur ne doive rien faire ? Non, et c'est normal. Un numéro de pass est nécessaire, et le droit est demandé à ce moment-là auprès de publiq. Rien n'est mémorisé.