Magnetic Stripe Card Reader Settings

Card Reader Type

Supported in:

Kiosk Pro Enterprise

Kiosk Pro supports several magnetic stripe card readers:

Default Value:
  • None
Other Possible Values:
  • ID Tech Shuttle or UniMag II
  • ID Tech iMag Pro II
  • MagTek iDynamo

IDTech readers are available in both encrypted and unencrypted format. MagTek readers are only available as encrypted devices. More information on this is available here.

Links to API documentation and sample code for each reader is available here.

Values for Remote Settings Control & Managed App Configuration

Key magneticCardReader
Key Type integer
Default Value 0
Possible Values
  • 0 = None
  • 1 = ID Tech Shuttle or UniMag II
  • 2 = ID Tech iMag Pro II
  • 3 = Magtek iDynamo


Swipe Timeout

Supported in:

Kiosk Pro Enterprise

Configure how long the swipe request should run before timing out.

Default Value: 20

Unit of Measurement: seconds

Note: This setting requires that you call the requestSwipe() call for the reader you are using with the parameter ’**swipe_params_from_settings**'.

Values for Remote Settings Control & Managed App Configuration

Key kp_requestSwipeTimeOut
Key Type string
Default Value 20


Swipe Request Text

Supported in:

Kiosk Pro Enterprise

Set the alert message that appears when asking for a visitor to swipe their card.

Default Value: Please swipe card.

Note: This setting requires that you call the requestSwipe() call for the reader you are using with the parameter ’**swipe_params_from_settings**'.

Values for Remote Settings Control & Managed App Configuration

Key mps_card_swipe_alert
Key Type string
Default Value Please swipe card.


Use Custom Graphics for Swipe Request

Supported in:

Kiosk Pro Enterprise

Set up custom graphics for the alert that appears when asking for a visitor to swipe their card.

Default Value: Off

Once enabled, you must create your graphic and name it ‘mps-swipe-overlay-portrait.png’ or ‘mps-swipe-overlay-landscape.png’ depending on whether your kiosk head will be portrait or landscape (or create both if the iPad is able to be turned). In the Kiosk Pro documents folder, create a folder called ‘KioskAssets’ and place your files inside this folder.

As Kiosk Pro is unable to detect whether the image file is for a low-resolution or a Retina screen, the size of the graphic you create should match the screen size of the device you are using.

Kiosk Pro will try to find the custom graphic file that matches your screen resolution, and if that size is unavailable, it will check for a smaller version:

Tablet Filename for Landscape Filename for Portrait
iPad Pro 12.9 mps-swipe-overlay-landscape@3x.png mps-swipe-overlay-portrait@3x.png
iPad with Retina screen mps-swipe-overlay-landscape@2x.png mps-swipe-overlay-portrait@2x.png
iPad with non-Retina screen mps-swipe-overlay-landscape.png mps-swipe-overlay-portrait.png

Values for Remote Settings Control & Managed App Configuration

Key mps_card_swipe_overlay_use_custom_graphics
Key Type boolean
Default Value false


Hide Native App Swipe Requests

Supported in:

Kiosk Pro Enterprise

Choose whether to hide the alert that appears when asking for a visitor to swipe their card.

Default Value: Off

As no special alert or graphic is shown on screen when this is enabled, your content should clearly explain to the visitor that they should swipe.

Values for Remote Settings Control & Managed App Configuration

Key mps_completely_hide_native_swipe_alert
Key Type boolean
Default Value false

Change Log

Added in version 3.1. Support for the encrypted Magtek iDynamo card reader added in version 4.2.

Still stuck? How can we help? How can we help?