Hardware

How do I check whether a QR code can be used for access for a specific time?

It can happen that the QR code associated with a Ballsport booking is not accepted when scanned by a customer at the access control. Here we show you how to find out why this has happened.

If you show your customers a QR code in the confirmation email for their ball sports booking, with which they can gain access to the sports hall via your access control, it is possible that this code does not work. 

In this article, we assume that your access control works technically and that the access control provider validates the QR codes with our check routines. If the following description does not give you the reason why the door did not open, please contact our technical support so that we can determine whether it is a technical fault.

E-Mail

Whenever the customer creates a ball sports booking, they automatically receive a confirmation email in which a QR code is displayed. If it is scanned with the QR code scanner at the time the booking is made (taking into account the set lead and follow-up times), the door is opened. Below the barcode in the email you will find the so-called booking token, which you can use to check whether and why a QR code opens the door or not. Select the token and copy it to the clipboard with CTRL + C (Windows) or command + C (Mac).

Checking the token

To check the token, first go to the ball sports manager. You will find a QR code symbol in the top right-hand corner of the daily schedule. Click on this.

In the following window you have to make the following entries:

Input field Meaning
Reader If you have more than one QR code reader in use, you can select the reader on which the code was scanned here. Otherwise, the correct reader is already preset here.
Date / Time Enter the date and time at which the customer scanned the code on the reader. This is important so that we can check whether the code was/is valid at this time.
Token Here you enter the token that you copied from the e-mail to the clipboard. You can do this with the key combination CTRL + V (Windows) or command + V (Mac). Alternatively, you can also enter the token directly using the keyboard

Now click on the check button. We will then check the token and give you the following information:

  • Lead and follow-up time
    How many minutes before and after the booking can the customer scan the code without it losing its validity?
  • Booking associated with the token
    This is the booking for which the booking confirmation (e-mail) was created. Either the individual booking or a booking from the customer's subscription.
  • Possible bookings (in the selected time)
    All bookings to which the customer had access in the time specified above, i.e. for which the door is opened. If no booking is specified here, then there is no booking for the customer at this time.
  • All possible bookings (-30 days to +30 days)
    All bookings to which the customer had or will have access in 30 days before and after the current date (i.e. now).

How is it checked whether a token is valid?

A token is encoded in the QR code that the reader sends to our verification interface. Here we first determine which booking this token belongs to. Then we use the booking holder's details to find all valid bookings made by the customer in the current period. If there is one, we return to the reader that the door can be opened.