How to integrate and configure your hardware with Playtomic Manager

This article explains how to connect your lights and access control hardware to Playtomic Manager and how to manage it once it's installed. It's for clubs that use a hardware provider such as Smart Padel, QT System or Micro Solution.

What's managed in Playtomic Manager and what's managed by your hardware provider?

Your hardware integration has two parts:

• Playtomic Manager sends your bookings to your hardware provider. Here you connect your provider with your API token, pair your Playtomic courts with the courts in your provider's system, test the lights and reset the integration.
• Your hardware provider's panel is where your lights and access control are configured. This includes the times when the lights turn on, the current status of the lights on each court, and errors on the hardware side.

For anything managed in your provider's panel, contact your hardware provider directly. Playtomic doesn't manage this configuration.

How do I set up the integration or add a new court?

The process is the same whether you're setting up for the first time or adding a new court.

Note: Before you start, make sure you're at your club and have your API token ready. Your hardware provider gives you this token.

1. Go to Settings > Integrations.
2. If you already have an integration installed and want to add a new court, open the integration and delete it with the bin icon in the top-right corner. Then continue with the next steps.
3. In the Connect new tab, select your hardware provider.
4. Paste your API token and click Next.
5. Pair your courts: use the dropdown to link each court to the matching court in your provider's system. If you only have keypads and no lights, you can skip this step.
6. Test the lights: click Turn on for each court. If the lights turn on, tick the box and move to the next court. If you only have lights and no keypads, you can skip the keypad step.
7. Set up keypads: create a 4-digit code and click Send. Check that the code unlocks the door, then mark it as done and continue with the other courts.
8. Set access rules: choose how long before and after a booking the access codes work, then click Next.
9. Set light rules: choose how long before and after a booking the lights stay on, then click Next.

Where can I find my integration settings?

1. Go to Settings > Integrations > Installed.
2. Click your hardware provider's integration.

You'll see these tabs:

• Access control: how long before and after a booking the access codes work.
• Lighting management: how long before and after a booking the lights stay on.
• Paired courts: the list of your courts and the hardware each one is connected to.
• Synchronization errors: hardware errors for this integration appear here when they happen.

How do I change how long the lights stay on before and after a booking?

1. Go to Settings > Integrations > Installed and click your hardware provider's integration.
2. Open the Lighting management tab.
3. Set how long before and after a booking the lights should stay on.
4. Click Save changes.

You can change these settings at any time. They apply to all courts paired with light control.

Why are my court lights turning on during the day?

The times when your court lights can turn on are set in your hardware provider's panel, not in Playtomic Manager. If your lights turn on when you don't need them, for example during daylight hours, check the light settings in your provider's panel. For help with these settings, contact your hardware provider.

How do I check which courts are paired and test the lights?

1. Go to Settings > Integrations > Installed and click your hardware provider's integration.
2. Open the Paired courts tab. The Integrations column shows what each court is connected to, for example Lights, Readers. Courts with None aren't paired, so the integration doesn't control their lights or access.
3. To test the lights on a paired court, click the court and then click Turn on. The lights turn on for a short time so you can check they're working.

How do I add, remove or edit a paired court?

To change which courts are paired, uninstall the integration and install it again:

1. Go to Settings > Integrations > Installed and click your hardware provider's integration.
2. Delete the integration with the bin icon in the top-right corner.
3. Follow the steps in "How do I set up the integration or add a new court?" in this article. During setup, you can pair your courts again.

Note: Have your API token ready before you delete the integration.

How do access codes work?

Access codes are created automatically for each booking and refresh 10 minutes before the match starts.

• If your club uses a hardware integration (for example QT System, Micro Solution or Smart Padel), a unique code is created for every match on the paired courts.
• The code appears in the match details, so managers and players can see it in advance.
• Players can go straight to the court and use the code to get in, without stopping at reception.

What should I do if the lights don't turn on or the doors don't open?

1. Go to Settings > Integrations > Installed and click your hardware provider's integration.
2. Open the Synchronization errors tab to see if any hardware errors are shown.
3. Click Reset integration in the top-right corner.
4. If you're still having problems, contact your hardware provider. They manage the hardware and its configuration.

💬 Need Help?

If you have any questions or need further assistance, don't worry! 😊 You can always contact us. We're here to help!