Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Export as PDF

PCI Requirements

PCI Requirements

Due to Payment Card Industry (PCI) certification requirements, the device must automatically reset at least once every 24 hours. This is required for security purposes, so that the device can reinitialize memory and perform a self-test. Host software developers and potentially end users should be aware of this.

By default, the device will automatically reset 23 hours after it boots up and it will attempt to send a warning notification message to the host 3 minutes before the reset occurs.

The default behavior is adjustable. See the following for more information:

  • Property 1.2.7.1.1.4 Auto Reset Configuration

  • Property 1.2.7.1.1.3 Device Reset Will Occur Soon Notification Control

  • Device Reset Will Occur Soon notification in Notification 0x1001 - Device Information Update

One way the host software could handle receiving a device reset-will-occur notification:

  1. Cancel any operation that is in process (for example, a transaction) if it is unlikely to end before the reset.

  2. Optionally send Command 0x1F01 - Reset Device instead of waiting for the automatic reset to occur.

  3. Re-connect with the device and re-start any operation that was in process.

Device Lock feature

The purpose of locking a device is to disable most of the device’s functionality for use cases that need this extra layer of security. When a device is locked, it will reject all commands except for a few. Use of the device lock feature is optional. It is not required by PCI.

  • The device lock state can be either unlocked or locked. The device lock state can be retrieved by getting a property.

  • The device lock state can be changed by setting a secure property or it can be changed with a command that requires knowledge of the device lock passcode.

  • The device can be configured to always have the device lock state set to locked after a reset or power cycle by setting a property.

  • If the device has a display and the device is locked, the welcome screen will display “WELCOME” “Device is Locked”. This screen can be customized.

  • The device lock passcode can be changed by setting a secure property or it can be changed with a command that requires knowledge of the current device lock passcode.

Commands and properties to manage the device lock feature:

  • Command 0xEF06 – Change Device Lock State

  • Command 0xEF07 – Change Device Lock Passcode

  • Property 1.2.3.1.1.2 Custom Idle Page Image Device Locked (Display Only)

  • Property 1.2.5.2.1.1 Device Lock State

  • Property 1.2.5.2.1.2 Device Lock State After Reset

  • Property 1.2.5.2.1.3 Device Lock Passcode

Only the following commands are allowed when the device lock state is set to locked:

  • Command 0x1F01 - Reset Device

  • Command 0x1F03 - Extend Session (Session Management Only)

  • Command 0x1F04 – Terminate Bluetooth® LE Connection (Bluetooth® LE Only)

  • Command 0xD101 - Get Property

  • Command 0xD112 - Set Property (Secured)

  • Command 0xDF01 - Echo

  • Command 0xE001 - Get Challenge

  • Command 0xEF06 – Change Device Lock State

  • Command 0xEF09 – Encrypt User Data

  • Command 0xEEEE - Send Secured Command to Device

Need Help?

For additional support, please contact MagTek Support:

Technical Support:

  • 📧 Email: support@magtek.com

  • 📞 Phone: 1-800-788-6835 (US) | +1-562-546-6616 (International)

  • 🕐 Hours: Monday-Friday, 6:00 AM - 5:00 PM PST

Online Resources:

Documentation Feedback:

Help us improve this documentation! Submit feedback

Last updated