Home/Access/Guides/Features/Qr Codes

2 Reader Configuration

2.1 QR Code Formats

SAFR SCAN supports following QR code formats

  • Card ID as Numeric Text
  • Card ID as Hexadecimal Text
  • Card UID as Text Mapped to Card ID

These are explained below

2.1.1 Card ID as Numeric Text

The Access Card ID is encoded into the QR code as an integer but represented as a string. The Facility ID (aka. Customer Code) is not encoded into the QR Code. The match is performed on the Access Card ID only, but when transmitting credentials to the panel, the Facility ID, if present, is included with the Access Card ID. For example:

Access Card ID in Decimal

Alphanumeric value

QR Code

12345

“12345”

A qr code with a white background

Description automatically generated

When SCAN reads that QR code, it will find the matching record (by Access Card ID only), get the Facility ID and combine the Facility ID and Access Card ID using the configured card format and transmit credentials to the panel.

2.1.2 Card ID as Hexadecimal Text

This option is similar to Card ID as Numeric Text, except the Access Card ID number encoded into the QR code should be converted to Hexidecimal and represented as a string. For example:

Access Card ID in Decimal

Access Card ID in Hexidecimal

Alphanumeric value

QR Code

123456789

075bcd15

“075bcd15”

For example: an Access Card Id of 123456789 is converted to a hex value 075bcd15 and a value of “075bcd15” is encoded into the string.

2.1.3 Card UID as Text Mapped to Card ID

This option stores the Card Serial Number (CSN) into the QR code. The CSN is more often referred to in SAFR as the Card UID. When working with physical access cards, UID can be either 32 bit or 56 bit value. But with QR codes, this can be any alphanumeric value (letters or numbers). The value is interpreted as a string and encoded into the QR code.

Example

UID

UID as string

QR Code

UID Example 1 (UID 56)

72057594037927936

“72057594037927936”

UID Example 2 (alpha numeric string)

234AMLT

“234AMLT”

A qr code on a white background

Description automatically generated

When reading a QR Code, UID is not actually sent to the panel. The value specified is used to search for matching person records. The Access Card ID and Facility code in the person record is then transmitted to the panel.

If more than one person record is matched, no data is sent to the panel unless using

How SAFR Matches