Page 1
MICRSafe Check Reader and Magnetic Stripe Reader Technical Reference Manual April 2019 Document Number: D99875466-33 REGISTERED TO ISO 9001:2015 MagTek I 1710 Apollo Court I Seal Beach, CA 90740 I Phone: (562) 546-6400 I Technical Support: (888) 624-8350 www.magtek.com...
Page 2
Microsoft® and Windows® are registered trademarks of Microsoft Corporation. All other system names and product names are the property of their respective owners. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 2 of 83 (D99875466-33)
Page 3
Command 0x01 - Get Property and Set Property, the host must first save any previously issued legacy setting changes; Misc. clarifications and corrections. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 3 of 83 (D99875466-33)
MagTek’s published specifications. This warranty shall be provided only for a period of one year from the date of the shipment of the product from MagTek (the “Warranty Period”). This warranty shall apply only to the “Buyer” (the original purchaser, unless that entity resells the product as authorized by MagTek, in which event this warranty shall apply only to the first repurchaser).
LIMITATION ON LIABILITY EXCEPT AS PROVIDED IN THE SECTIONS RELATING TO MAGTEK’S LIMITED WARRANTY, MAGTEK’S LIABILITY UNDER THIS AGREEMENT IS LIMITED TO THE CONTRACT PRICE OF THIS PRODUCT. MAGTEK MAKES NO OTHER WARRANTIES WITH RESPECT TO THE PRODUCT, EXPRESSED OR IMPLIED, EXCEPT AS MAY BE STATED IN THIS AGREEMENT, AND MAGTEK DISCLAIMS ANY IMPLIED WARRANTY, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Reduction of Hazardous Substances (RoHS) European Directive 2002/95/EC. The marking is clearly recognizable, either as written words like “Pb-free,” “lead-free,” or as another clear symbol ( MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 6 of 83 (D99875466-33)
ATTENTION: CUSTOMER SUPPORT. TERMS, CONDITIONS, AND RESTRICTIONS MagTek, Incorporated (the "Licensor") owns and has the right to distribute the described software and documentation, collectively referred to as the "Software." LICENSE: Licensor grants you (the "Licensee") the right to use the Software in conjunction with MagTek products.
Page 8
Agreement and will not affect the enforceability of any of the remaining provisions. This Agreement shall be governed by the laws of the State of California and shall inure to the benefit of MagTek, Incorporated, its successors or assigns.
Command ‘SWC’ - Switch C ......................26 4.5.1 CMC-7 Character Set ......................27 4.5.2 Invalid Command Response ....................27 4.5.3 Data Header ..........................27 4.5.4 Card Data Message ....................... 27 MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 9 of 83 (D99875466-33)
Page 10
Property 0x01 - Serial Num ....................47 5.2.3 Property 0x02 - Polling Interval ................... 48 5.2.4 Property 0x04 - Track Data Send Flags ................49 MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 10 of 83 (D99875466-33)
Page 11
Step 13: No MICR Data Detected .................... 69 D.17 Step 14: Cable Problem ......................69 D.18 Step 15: No Problem Found ..................... 69 D.19 Step 16 Read Insta-Change Check ..................69 MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 11 of 83 (D99875466-33)
Page 12
Step 17: Return MICRSafe for Service ..................69 Appendix E ASCII Codes ..........................71 Appendix F Usage ID Definitions ......................73 Appendix G Modifier Byte Definitions ...................... 83 MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 12 of 83 (D99875466-33)
MICRSafe with 3-Track MSR is both a MICR (Magnetic Ink Character Recognition) check reader and an MSR (magnetic stripe reader). MICRSafe, in a typical application, reads the magnetic data encoded on the bottom of checks or on magnetic stripe cards and transmits this data to a host device. The host device then uses a specific authorization or verification process to validate a business transaction.
Page 14
4 Legacy Commands). Depending on POS connection port, a ‘Mini DIN 9 Pin’ or a ‘DB9’ cable can be used to connect. Communication in this mode is one-way only, outputting data from MICRSafe to POS terminal. Baud rate is always set to 9600 bps.
VCOM port. In that case, you would need to download the VCOM driver from the MagTek website. This driver allows a USB device such as MICRSafe to appear as an additional COM port available to the PC, enabling application software to access the USB device as if it were connected via a standard COM (RS-232) port.
5) The first time the device is connected to the PC, Windows needs to install the USB driver. See the instructions below. 6) The LED indicator on MICRSafe should turn solid green. The LED indicator is located to the left of the slot where the check is first inserted for reading.
2 - Installation USB Driver Installation (Windows) On hosts with the Windows operating system, the first time MICRSafe is plugged into a specific USB port, Windows opens a dialog box to guide you through the process of installing a driver; follow the instructions.
This section contains check and card reading procedures and LED indicator states. Check Reading Procedure 1) Orient the check so the MICR line is down and the printed side faces the center of MICRSafe as shown in Figure 3-1. Figure 3-1 - Check Orientation 2) Drop the check so the leading edge is in the open slot.
Page 20
Data sensor blocked (motor does not run) FLASH RED/GREEN See Appendix D Troubleshooting Guide. Motor sensor blocked (motor does not run) FLASH RED See Appendix D Troubleshooting Guide. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 20 of 83 (D99875466-33)
If your MICRSafe is using a VCOM port, the legacy MICR commands found in this section may be sent to the device exactly as described in this section. However, if your MICRSafe is using an HID interface, you must send the legacy commands to the device using Command 0x07 - Send Legacy Command.
No spaces, brackets, or angle brackets required. If MICRSafe is using an HID Keyboard Emulation interface, all legacy MICR commands found in this section must be sent to the device using Command 0x07 - Send Legacy Command. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual...
SWB<CR> (without data) When sending data, all 8 bits must be provided. MICRSafe executes the command but it does not reply. The new settings become effective immediately. To make this setting permanent, the host MUST send Command ‘SA’ - Save.
<CR> Carriage Return <LF> Line Feed For example, if the <STX> and <CR> options are set to YES, a MICR Data message from MICRSafe looks like this: MICR Data: <STX>data<CR> 4.4.2 Control Characters and Card Data If the card reader’s head is set to security level 2, then the same control characters may also be added to Card Data messages, but they are applied to each track individually.
The Send Data After Error option specifies whether MICRSafe returns data to the host after a read error. If YES is selected and MICRSafe detects a read error, MICRSafe still sends the data back to the host. If NO is selected and MICRSafe finds an error, it discards the data and sends nothing. The error conditions are listed in Table 4-3.
(with data) SWC<CR> (without data) When sending data, all 8 bits must be provided. MICRSafe executes the command but does not reply. The new settings become effective immediately. To make this setting permanent, the host MUST send Command ‘SA’ - Save.
The first option “ ?<CR> ” is the default. If MICRSafe receives an unrecognized command, it returns a question mark and carriage return to the host. MICRSafe then returns to an idle state and waits for further commands or check/credit card reads.
HW <CR> (without data) When sending data, all 8 bits must be provided. MICRSafe executes the command but does not reply. The new settings become effective immediately. To make this setting permanent, the host MUST send Command ‘SA’ - Save.
The EMF Detect option allows the MICR Reader, when idle, to monitor EMF interference in its immediate environment. If YES is selected, the LED indicator blinks red/green when MICRSafe detects a signal with amplitude large enough to affect check reading. If NO is selected, MICRSafe does not monitor nor indicate the presence of EMF interference.
FCXXXX<CR> (with data) FC<CR> (without data) When sending data, all 4 digits must be provided. MICRSafe executes the command but does not reply. The new settings become effective immediately. To make this setting permanent, the host MUST send Command ‘SA’ - Save.
4.13 Command ‘KS’ - Enable Keystroke This command determines if MICRSafe sends responses to the host via the USB interrupt pipe or as Keystrokes (that appear to the host application as if typed on a keyboard). To execute, send the KS command followed by a carriage return as follows: <CR>...
Page 32
4 - Legacy Commands MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 32 of 83 (D99875466-33)
The device does not support remote wakeup. This device is powered from the USB bus. The vendor ID is 0x0801 and the product ID is 0x2251. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 33 of 83 (D99875466-33)
Windows Notepad) can be used. 5.1.2 About Card Data and MICR Data MICRSafe converts magnetic stripe card data and MICR data to ASCII and transmits it to the host as if it had been typed on a keyboard. Because of potential “data interleave” issues associated with the USB Keyboard interface, MagTek recommends that you do not depress the keyboard while swiping a card or scanning a check.
Firmware in the device’s magnetic stripe reader normally handles card swipes, gets MagnePrint data, and encrypts the data. It then passes the output to firmware in MICRSafe for transmission to the host. The firmware controls all functions relating to check reading and handles all communication between the host and the device.
Result Code Description SUCCESS The command completed successfully. FAILURE The command failed. The command failed due to a bad parameter or BAD_PARAMETER command syntax error. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 38 of 83 (D99875466-33)
Property Value is a multiple-byte field that contains the value of the property. The number of bytes in this field depends on the type of property and the length of the property. The following table lists all of MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 39 of 83 (D99875466-33)
Page 40
This is a multiple byte ASCII string. Its length can range from zero to a maximum String length that depends on the property. The value and length of the string does not include a terminating NUL character. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 40 of 83 (D99875466-33)
USB port before trying to communicate further. Example Request (Hex): Cmd Num Data Len Data Example Response (Hex): Result Code Data Len Data MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 41 of 83 (D99875466-33)
0x02 (left shift key) is mapped to ASCII character ‘?’. Example Request (Hex) Cmd Num Data Len Data Example Response (Hex) Result Code Data Len Data 38 02 MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 42 of 83 (D99875466-33)
The following example maps the card ASCII data end sentinel character ‘?’ to the ‘>’ keyboard key. Example Request (Hex): Cmd Num Data Len Data 3F 37 02 Example Response (Hex): Result Code Data Len Data MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 43 of 83 (D99875466-33)
Request Data: None Response Data: None Result codes: 0 (success) Example Request (Hex) Cmd Num Data Len Data Example Response (Hex) Result Code Data Len Data MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 44 of 83 (D99875466-33)
Data Len Data (SWB<CR>) 53 57 42 0D Example Response (Hex): Result Code Data Len Data Example Legacy Command Response (sent as keystrokes): SWB=00000000<CR> MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 45 of 83 (D99875466-33)
This device has a number of programmable configuration properties. These properties are stored in non- volatile memory, and can be configured at the factory or by an advanced operator using a program supplied by MagTek. Programming these parameters requires low level communication with the device. 5.2.1 Property 0x00 - Software ID...
Example Get Serial Num property Response (Hex): Result Code Data Len Prp Value 32 32 38 32 37 30 32 31 41 30 31 MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 47 of 83 (D99875466-33)
Example Get Polling Interval property Request (Hex): Cmd Num Data Len Prp ID Example Get Polling Interval property Response (Hex): Result Code Data Len Prp Value MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 48 of 83 (D99875466-33)
This property is stored in non-volatile memory, so it will persist when the unit is power cycled. When this property is changed, the device must be reset (see Command Number 2) or power cycled for these changes to take effect. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 49 of 83 (D99875466-33)
Example Get ASCII To Keypress Conversion Type property Request (Hex): Cmd Num Data Len Prp ID Example Get ASCII To Keypress Conversion Type property Response (Hex): Result Code Data Len Prp Value MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 50 of 83 (D99875466-33)
Example Get Active Key Map property Request (Hex): Cmd Num Data Len Prp ID Example Get Active Key Map property Response (Hex): Result Code Data Len Prp Value MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 51 of 83 (D99875466-33)
Example Get Convert From Char A property Request (Hex): Cmd Num Data Len Prp ID Example Convert From Char A property Response (Hex): Result Code Data Len Prp Value MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 52 of 83 (D99875466-33)
Example Get Convert To String A property Request (Hex): Cmd Num Data Len Prp ID Example Get Convert To String A property Response (Hex): Result Code Data Len Prp Value 0D 0D MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 53 of 83 (D99875466-33)
Example Get Convert From Char B property Request (Hex): Cmd Num Data Len Prp ID Example Convert From Char B property Response (Hex): Result Code Data Len Prp Value MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 54 of 83 (D99875466-33)
Example Get Convert To String B property Request (Hex): Cmd Num Data Len Prp ID Example Get Convert To String B property Response (Hex): Result Code Data Len Prp Value 0D 0D MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 55 of 83 (D99875466-33)
MagneSafe MSR Technical Manual, P/N D99875433. If the encryption feature is not set, then MICRSafe will output data in SureSwipe format. See P/N D99875206 for more information about this non-encrypted output format.
6 - Encryption About Encrypted Check Data MICRSafe can be similarly configured to encrypt MICR data from scanned checks. See Table 6-1 for information about how the host should interpret this data. Table 6-1 - Interpreting Encrypted MICR Data Length...
32°F to 122°F (0°C to 50°C) Operating Relative Humidity: 10% to 90% non-condensing Storage Temperature: -22°F to 140°F (-30°C to 60°C) Storage Relative Humidity: Up to 95% non-condensing MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 58 of 83 (D99875466-33)
Appendix B Format List For check reading, MICRSafe provides the flexibility to format the MICR fields and build a specific output string that will be transmitted to the host. These output strings are referred to as formats. The Reader has a built-in list of formats (described below) from which the user may select one to become the active format every time a check is read.
Page 60
'T' [transit] 'A' [acct #] 'C' [check #] • [transit]: - all characters in the field - keep dashes • [acct #]: - all characters are sent MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 60 of 83 (D99875466-33)
Page 61
Select this format to activate a preloaded Flexible Format. The Flexible Format is a feature that allows the user to create custom MICR formats. The Flexible formats can be easily created and downloaded using the Windows based MICRbase program provided by MagTek (P/N 22000021). For more detailed information refer to MICRbase reference manual D99875102.
The characters printed on the bottom line of commercial and personal checks are special. They are printed with magnetic ink to meet specific standards. These characters can be read by a MICRSafe at higher speeds and with more accuracy than manual data entry. Two MICR character sets are used worldwide;...
CMC-7 Character Set The numbers and symbols of the CMC-7 character set are as follows: SI SII SIII SIV SV The nonnumeric CMC-7 characters are translated by MICRSafe as shown in Table 6-2. Table 6-2 - CMC-7 Non-numeric Characters CMC-7 Character...
Personal checks with MICR fields are shown in Figure 6-1. Business checks are shown in Figure 6-2. The digits 1 through 4 in the illustrations are described below under MICR Fields. Figure 6-1 -Personal Checks Figure 6-2 -Business Checks MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 64 of 83 (D99875466-33)
The Auxiliary On-Us field is variable, 4-10 digits, bracketed by two On-Us symbols. This field is not present on personal checks. On business checks, this field contains the check serial number. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 65 of 83 (D99875466-33)
DC adapter connection to outlet - make sure the DC adapter is securely connected to outlet on the wall or power strip. DC adapter connection to MICRSafe - make sure the DC adapter is securely connected to MICRSafe’s power connector. ...
Use the “Configure” option within MICRbase to verify the following parameters: "Send Data After Error" - if this option is set to NO, MICRSafe will not send any data after a read error. Use MICRbase to change this option to YES.
Loose debris - power off MICRSafe and try to push out any loose debris on the check path. Use a cleaning card and force it through the check path (this is a manual process, the motor will not turn on).
Cleaning card - power off MICRSafe and try to push out any loose debris in the check path. Use a cleaning card and force it through the check path (this is a manual process, the motor will not turn on).
Page 70
Appendix D - Troubleshooting Guide Figure 6-3 - Sensor Location MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 70 of 83 (D99875466-33)
This table lists the ASCII (American Standard Code for Information Interchange) codes. ASCII is a 7-bit code which is represented here by a pair of hexadecimal digits. ASCII ASCII ASCII ASCII " & < MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 71 of 83 (D99875466-33)
Page 72
Appendix E - ASCII Codes ASCII ASCII ASCII ASCII > MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 72 of 83 (D99875466-33)
√ √ √ Keyboard h and H 4/101/104 √ √ √ Keyboard i and I 4/101/104 √ √ √ Keyboard j and J 4/101/104 MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 73 of 83 (D99875466-33)
Page 81
33) The symbol displayed will depend on the current locale settings of the operating system. For example, the US thousands separator would be a comma, and the decimal separator would be a period. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 81 of 83 (D99875466-33)
Page 82
34) The symbol displayed will depend on the current locale settings of the operating system. For example the US currency unit would be $ and the sub-unit would be ¢. MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 82 of 83 (D99875466-33)
The modifier byte is defined as follows: Table 6-4 - Modifier Byte Definitions LEFT CTRL LEFT SHIFT LEFT ALT LEFT GUI RIGHT CTRL RIGHT SHIFT RIGHT ALT RIGHT GUI MICRSafe| Check Reader and Magnetic Stripe Reader | Technical Reference Manual Page 83 of 83 (D99875466-33)
Need help?
Do you have a question about the MICRSafe and is the answer not in the manual?
Questions and answers