Configuring PINs with leading zeros for Mercury controllers

2025-07-02Last updated

By default, Mercury doesn't support PIN credentials that start with zero. To use PINs that start with zero, you must configure the Mercury controller settings in the Synergis™ Appliance Portal.

What you should know

Using PIN credentials in the Mercury integration requires the following:
  • Each cardholder in Security Center must have a card credential and only one PIN credential.
  • On the Unit-wide parameters page of the Synergis Appliance Portal, if the reader is set to Card or PIN, but the cardholder only has a PIN credential, that credential isn’t synchronized to the Mercury controller and doesn't work. As a workaround, create and assign the cardholder a dummy card credential.
Mercury controller settings in the Synergis Appliance Portal affect each other in the following ways:
  • The system prevents you from configuring a PIN length after adding leading zeros value that exceeds the Maximum PIN length value.
  • Leading zeros are added to shorter PINs until they reach the PIN length after adding leading zeros value, not the Maximum PIN length value.
  • PINs that are already equal to or longer than the PIN length after adding leading zeros value are valid, as long as they don't exceed the Maximum PIN length value.

Procedure

  1. Log on to the Synergis Cloud Link unit.
  2. Click Configuration > Mercury controller settings .
  3. Under the Include and add leading zeros for PINs setting, select Custom.
    By default, this setting is configured to Unset, and PINs don't have leading zeros.
  4. Under the PIN length after adding leading zeros, enter a value.
    This setting indicates the total number of digits in a PIN, including zeros added before the PIN. Zeros are only added before the PIN if the original PIN is shorter than this setting's value.
  5. Click Save.
  6. Perform a software restart.

Example

The Maximum PIN length is set to 6, and the PIN length after adding leading zeros is set to 4. The following occurs:
  • If the original PIN was 9, the PIN becomes 0009.
  • If the original PIN was 123, the PIN becomes 0123.
  • If the original PIN was 12345, then the PIN remains the same.