<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=412158892933457&amp;ev=PageView&amp;noscript=1">
Skip to content
English
Submit Ticket
  • There are no suggestions because the search field is empty.

Configure Hapana MAC Doors in Core

Configure Hapana MAC Doors in Core

Overview

This guide walks you through how to configure Hapana MAC (Member Access Control) doors in Core V1.

Setting up MAC doors allows members to securely access your facility using Hapana’s access control hardware. The process involves:

  • Creating an access group
  • Provisioning the physical door device
  • Linking the device to a door inside Core
  • Generate a QR Code for Door Access Control

Prequerquisites

Before starting, make sure you have:

  • Physical access to the Hapana MAC door hardware
  • Administrator access to Core
  • Your Hapana API credentials configured (completed by your admin or Hapana team)
  • The device powered on and connected to the internet

Tip: Provision codes expire quickly (usually within 5–10 minutes), so complete the steps promptly once generated.

Step 1: Open the Hapana Access Management Interface

  1. Log in to Core.
  2. Click your User Profile in the top right corner.
  3. Select Account Settings.
  4. Click the Integrations tab.
  5. Scroll down to Hapana Access.
  6. Click Manage.

This opens the Hapana Access Management modal where you will configure groups and access points.

Step 2: Create an Access Group

Access groups define which members can access which doors. Typically, you’ll create one group per site or per door.

  1. In the Hapana Access modal, locate the Groups section.
  2. In the Create New Group field, enter a descriptive group name (e.g. SITE1-MAIN-ENTRANCE or FRONT-DOOR-ACCESS).
  3. Click Create Group.
  4. Click Manage again to refresh the view.
  5. Note the newly created Group ID - you will need this later.

Best Practices for Naming Groups

  • Use descriptive names.
  • Use hyphens instead of spaces.
  • Include your site identifier if managing multiple locations.

Example: GYM-FLOOR-ACCESS

Step 3: Provision the Physical Access Point

Each physical MAC device must be provisioned before use. This links the hardware to your account.

On the Physical Device:

  1. Locate the Hapana MAC access control unit.
  2. Press the information icon (if applicable).
  3. Find the Provision Code displayed on the device.
    • This is usually 6–8 characters.
    • It may begin with a dash.
    • The code is temporary.

Important: Do not include the dash when entering the code into Core.

In Hapana Core:

  1. In the Hapana Access modal, go to the Provision Access Point section.
  2. Select your newly created group from the Hapana Group dropdown.
  3. Enter the Provision Code (without the dash).
  4. Enter a name for the access point (e.g. “Front Door Device”).
  5. Click Provision Access Point.

If successful, the modal will close and display:

  • Access Point ID

Make sure you record both:

  • Group ID
  • Access Point ID

You’ll need these when linking the device to a door.

Step 4: Configure Your Door for Access Control

 

Now that your Hapana MAC device has been provisioned, you need to add and configure the door inside Core.

This step links your physical hardware to the Hapana system so members can access the door.

Add the Door in Core

  1. Go to Account Settings.
  2. Select Integrations.
  3. Scroll down to Access Controls.
  4. Click Add Door.

This will open the door configuration modal.

Complete the Door Configuration Fields

Fill in the required fields as follows:

Basic Information

  1. In Provider, select Hapana.
  2. In Door Name, enter a clear label (e.g. Front Door, Main Entrance, Studio A).
  3. In Access Group ID, enter the Group ID created earlier (Step 2).

Technical Configuration

  1. In Door ID, enter the Access Point ID you received when provisioning the device (Step 3).
  2. (Optional) Enter WiFi Name and WiFi Password for internal reference.

Important: The Door ID must exactly match the Access Point ID from provisioning.

  1. Select the relevant Session Types for this door.
    • Example: For a main entrance, select General Check-In.
  2. Click Save.

After the Door is Added

Once saved, the door will appear in your Access Controls list.

From here, you can:

  • Click Update to edit credentials or session types.
  • Click Delete to remove the door.
  • Click Open Door to remotely unlock the door for testing or staff entry.

Tip: Use the Open Door button to confirm the device is correctly connected before going live.

Important Notes

  • The Provider cannot be changed after the door is created.
  • Each door must use the correct Group ID and Access Point ID.
  • The Access Group ID links this door to the correct member access list.

If incorrect credentials are entered, use Update to fix them rather than deleting and recreating the door.

Step 5: Generate a QR Code for Door Access Control

You can generate a unique QR code for each MAC door to enable contactless access. This QR code can be displayed at the entrance for members to scan.

Generate the QR Code

  1. Click your User Profile in the top right corner.
  2. Select Edit Profile.
  3. Click on Contactless Check-In.
  4. Within Access Integration, open the door dropdown menu.
  5. Select the newly created door.
  6. Click Generate QR Code.
  7. Confirm when prompted.

A unique QR code will now be created specifically for that door.

Download the QR Code

  1. Click the View icon next to the generated QR code.
  2. Click Download.
  3. Save the QR code image file.

This is the QR code that should be displayed at the door for members to scan.

Important Notes

  • Each QR code is unique to the selected door.
  • If you create multiple doors, you must generate a QR code for each one.
  • If a door is deleted and recreated, a new QR code should be generated.

Tip: Print the QR code clearly and place it near the door scanner at eye level for best usability.

Once generated and displayed, members can use contactless check-in to unlock the door based on their valid access permissions.

This completes the MAC door configuration process. Once saved, eligible members will be able to access the door based on their membership and session type permissions.