<aside> 👉 Cette API permet la gestion des réservations individuelles pass Culture. Elle permet d’être notifié en temps réel des réservations, d’envoyer les informations des billets vers l’application pour les offres d’événements soumis à une billetterie et autorise la validation et l’invalidation des réservations sans passer par le Guichet pass Culture pro.

• Sommaire </aside>

Contexte

La réservation d’un jeune est matérialisée par

• une contremarque pour toutes les réservations de produits physiques ou numériques
• un billet pour tous les événements qui ont été créés par un logiciel de billetterie synchronisé en temps réel avec le pass Culture
• une mention spécifique invitant le jeune à se tourner vers l’acteur culturel pour les événements non synchronisés en temps réel avec le pass Culture

La contremarque d'une réservation, ou token est le code associé à une réservation, servant de preuve de réservation.

Elle permet :

• à un jeune de récupérer le bien réservé
• à un acteur culturel de confirmer que le jeune a récupéré le bien réservé

Comprendre les statuts des réservations

Cas des offres de type Produit :

• Une réservation est au statut “réservé” si elle n’est ni remboursée, ni annulée, ni validée
• Une réservation est au statut “validé” si elle est validée (si la contremarque a été validée dans le guichet ou en cas de validation automatique)
• Une réservation est au statut “annulé” si elle est annulée (par le jeune ou par l’acteur culturel)
• Une réservation est au statut “remboursé” si le pass Culture a payé l’acteur culturel pour la réservation validée

Cas particulier des offres de type Événement :

• Une réservation est au statut “confirmé“ - uniquement pour les offres d'événements - si l'offre n'est plus annulable par le jeune (48h après sa réservation et 48h avant l'événement)
• La réservation passe automatiquement au statut “validé” après la tenue de l’événement. Toutes les réservations non déjà validées pour des événements ayant eu lieu il y a plus de 48 heures sont validées en masse à 00:00 UTC (soit 2:00 heures de Paris).

Dans tous les cas, la réservation passera au statut “remboursé” quand le pass Culture aura effectué le virement pour payer les acteurs culturels. Les virements ont lieu 2 fois par mois, au début du mois et à l’issu de la première quinzaine.

1. Être notifié d’une réservation

Pour cela, vous devez transmettre aux équipes du pass Culture différentes URLs :

• Pour les événements soumis à la présentation d’un billet
  • une route pour la validation des demandes de réservation et la transmission des informations des billets associés
  • une route pour l’annulation des réservations
• Pour toutes les autres offres (événements sans billet, offres physiques, offres numériques)
  • une route pour la validation ou l’annulation des réservations.