Define and register a badge reader device manually

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

    • Manually create a badge reader device for registration in your system. Registering your badge reader enables you to make it operational at your Walk-up Experience on-site queue.

    Before you begin

    Role required: sn_badge.badge_admin

    About this task

    There are two ways to define and register a badge reader device:

    Procedure

    1. To manually register your badge reader device, navigate to Badge Reader Integration > Badge Readers.
    2. Click New.
    3. In the Name field, specify a name for the badge reader.
      For example, Building B Tech Lounge Badge Reader.
      Note:
      The Status field is read-only. This field is set to New when configuring a new badge reader. The field is in the Activated state when a badge reader is approved for activation. If a badge reader is deactivated, the field is set to Deactivated.
    4. Select a Badge Event Handler.
      Note:
      If no badge event handlers are available to select, create a new Badge Event Handler record. For details about this process, refer to Create or modify Badge Reader Integration event handlers.
    5. Specify the Device Identifier.
      The Device Identifier uniquely identifies the badge reader hardware. The client defaults to using the badge reader device serial number. The value entered must match the device serial number received from the client software application.
      Note:
      The Secret Key field is automatically populated when you create the badge reader record.
    6. Select User Badge Configuration.
      The badge reader uses this mapping configuration to retrieve the user ID from the badge ID when the requester scans their badge to check in to a location.
      Note:
      By default, a user badge configuration is available to select. For more information on defining a new user badge configuration, see Define a user badge configuration.
    7. Optional: Specify the non-mandatory Short description and Location form fields if desired.
    8. Register the badge reader by selecting Submit.