magnesafe secure card reader authenticator … · magnesafe secure card reader authenticator ......

28
MagTek I 1710 Apollo Court I Seal Beach, CA 90740 I Phone: (562) 546-6400 I Technical Support: (888) 624-8350 www.magtek.com iDynamo MagneSafe Secure Card Reader Authenticator Installation and Operation Manual November 21, 2014 Manual Part Number: D99875473-110 REGISTERED TO ISO 9001:2008

Upload: dokien

Post on 09-Sep-2018

222 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

MagTek I 1710 Apollo Court I Seal Beach, CA 90740 I Phone: (562) 546-6400 I Technical Support: (888) 624-8350

www.magtek.com

iDynamo MagneSafe Secure Card Reader Authenticator

Installation and Operation Manual

November 21, 2014

Manual Part Number:

D99875473-110

REGISTERED TO ISO 9001:2008

Page 2: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 2

Copyright © 2006 - 2014 MagTek, Inc.

Printed in the United States of America

Information in this publication is subject to change without notice and may contain technical inaccuracies

or graphical discrepancies. Changes or improvements made to this product will be updated in the next

publication release. No part of this document may be reproduced or transmitted in any form or by any

means, electronic or mechanical, for any purpose, without the express written permission of MagTek, Inc.

MagTek® is a registered trademark of MagTek, Inc.

MagnePrint® is a registered trademark of MagTek, Inc.

Magensa™ is a trademark of MagTek, Inc.

MagneSafe™ is a trademark of MagTek, Inc.

IPAD® is a registered trademark of MagTek, Inc.

iDynamo™ is a trademark of MagTek, Inc.

iPhone®, iPod®, iPod Touch®, and Mac® are registered trademarks of Apple Inc., registered in the U.S.

and other countries. App StoreSM is a service mark of Apple Inc., registered in the U.S. and other

countries. IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used

by Apple Inc. under license.

iPad™, iPad Air™, and iPad mini™ are trademarks of Apple, Inc.

All other system names and product names are the property of their respective owners.

Table 0.1 - Revisions

Rev Number Date Notes

1.01 February 2, 2010 Initial Release

2.01 May 24, 2010 Added Operation section; added iPad compatibility;

included physical dimensions

3.01 July 21, 2010 Added list of accessories with references to the iPod touch

adapter and references to the extension cable

4.01 February 15, 2011 Add picture and references to iDynamo (21073084); add

additional adapters in accessories section

5.01 August 15, 2011 Added Appendix A for adapter dimensions

6.01 November 4, 2011 Updated the dimensions of the iDynamo

7.01 November 22, 2011 Added iPad 2 adapter

8.01 September 18, 2012 Updated drawings

9.01 January 17, 2013 Add notes on charging iPad

[1.01 Merged] July 9,2013 Initial release of iDynamo 5 content as 99870003

10.01 August 1, 2013 Reformat, remove references to obsolete parts, merge

contents of 99870003, add charging and synchronization

section, clean up language and flow, incorporate Marketing

feedback

110 November 21, 2014 Update adapters and accessories table and adapters in

appendix B; update trademarks; general corrections

Page 3: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 3

Page 4: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 4

LIMITED WARRANTY

MagTek warrants that the products sold pursuant to this Agreement will perform in accordance with

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).

During the Warranty Period, should this product fail to conform to MagTek’s specifications, MagTek

will, at its option, repair or replace this product at no additional charge except as set forth below. Repair

parts and replacement products will be furnished on an exchange basis and will be either reconditioned or

new. All replaced parts and products become the property of MagTek. This limited warranty does not

include service to repair damage to the product resulting from accident, disaster, unreasonable use,

misuse, abuse, negligence, or modification of the product not authorized by MagTek. MagTek reserves

the right to examine the alleged defective goods to determine whether the warranty is applicable.

Without limiting the generality of the foregoing, MagTek specifically disclaims any liability or warranty

for goods resold in other than MagTek’s original packages, and for goods modified, altered, or treated

without authorization by MagTek.

Service may be obtained by delivering the product during the warranty period to MagTek (1710 Apollo

Court, Seal Beach, CA 90740). If this product is delivered by mail or by an equivalent shipping carrier,

the customer agrees to insure the product or assume the risk of loss or damage in transit, to prepay

shipping charges to the warranty service location, and to use the original shipping container or equivalent.

MagTek will return the product, prepaid, via a three (3) day shipping service. A Return Material

Authorization (“RMA”) number must accompany all returns. Buyers may obtain an RMA number by

contacting Technical Support at (888) 624-8350.

EACH BUYER UNDERSTANDS THAT THIS MAGTEK PRODUCT IS

OFFERED AS IS. MAGTEK MAKES NO OTHER WARRANTY, EXPRESS OR

IMPLIED, AND MAGTEK DISCLAIMS ANY WARRANTY OF ANY OTHER

KIND, INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS

FOR A PARTICULAR PURPOSE.

IF THIS PRODUCT DOES NOT CONFORM TO MAGTEK’S SPECIFICATIONS, THE SOLE

REMEDY SHALL BE REPAIR OR REPLACEMENT AS PROVIDED ABOVE. MAGTEK’S

LIABILITY, IF ANY, SHALL IN NO EVENT EXCEED THE TOTAL AMOUNT PAID TO MAGTEK

UNDER THIS AGREEMENT. IN NO EVENT WILL MAGTEK BE LIABLE TO THE BUYER FOR

ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL

OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF, OR INABILITY TO USE,

SUCH PRODUCT, EVEN IF MAGTEK HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH

DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.

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

Page 5: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 5

WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

MAGTEK SHALL NOT BE LIABLE FOR CONTINGENT, INCIDENTAL, OR CONSEQUENTIAL

DAMAGES TO PERSONS OR PROPERTY. MAGTEK FURTHER LIMITS ITS LIABILITY OF ANY

KIND WITH RESPECT TO THE PRODUCT, INCLUDING ANY NEGLIGENCE ON ITS PART, TO

THE CONTRACT PRICE FOR THE GOODS.

MAGTEK’S SOLE LIABILITY AND BUYER’S EXCLUSIVE REMEDIES ARE STATED IN THIS

SECTION AND IN THE SECTION RELATING TO MAGTEK’S LIMITED WARRANTY.

FCC WARNING STATEMENT

This equipment has been tested and was found to comply with the limits for a Class B digital device

pursuant to Part 15 of FCC Rules. These limits are designed to provide reasonable protection against

harmful interference when the equipment is operated in a residential environment. This equipment

generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with

the instruction manual, may cause harmful interference with radio communications. However, there is no

guarantee that interference will not occur in a particular installation.

FCC COMPLIANCE STATEMENT

This device complies with Part 15 of the FCC Rules. Operation of this device is subject to the following

two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any

interference received, including interference that may cause undesired operation.

CANADIAN DOC STATEMENT

This digital apparatus does not exceed the Class B limits for radio noise from digital apparatus set out in

the Radio Interference Regulations of the Canadian Department of Communications.

Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites applicables aux

appareils numériques de la classe B prescrites dans le Réglement sur le brouillage radioélectrique édicté

par le ministère des Communications du Canada.

This Class B digital apparatus complies with Canadian ICES-003.

Cet appareil numérique de la classe B est conformé à la norme NMB-003 du Canada.

CE STANDARDS

Testing for compliance with CE requirements was performed by an independent laboratory. The unit

under test was found compliant with standards established for Class B devices.

UL/CSA

This product is recognized per Underwriter Laboratories and Canadian Underwriter Laboratories 1950.

ROHS STATEMENT

When ordered as RoHS compliant, this product meets the Electrical and Electronic Equipment (EEE)

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 ( ).

Page 6: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

0 - Table of Contents

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 6

Table of Contents

Table of Contents ............................................................................................................................... 6

1 Introduction ................................................................................................................................. 8

1.1 About iDynamo .................................................................................................................... 8

1.2 Product Features ................................................................................................................. 8

1.3 Planning................................................................................................................................ 9

2 Installation ................................................................................................................................. 11

2.1 How to Install iDynamo and Software the First Time .................................................. 11

2.2 How to Re-Install Software .............................................................................................. 12

3 Operation ................................................................................................................................... 13

3.1 How to Check Device Status ........................................................................................... 13

3.2 How to Set Up Charging and Synchronization .............................................................. 14

3.3 About Power Saving Mode............................................................................................... 15

4 Developing Custom Apps ........................................................................................................ 16

4.1 About Device Detection ................................................................................................... 16

4.2 About Security ................................................................................................................... 16

4.3 About Card Reads ............................................................................................................. 16

4.4 About States ...................................................................................................................... 16

Appendix A Technical Specifications ....................................................................................... 18

Appendix B iDynamo Adapters ................................................................................................. 19

B.1 iPhone 4/4S Adapter Sleeve (21041050) ................................................................... 19

B.2 iPad Adapter Sleeve (21041051) .................................................................................. 20

B.3 iPhone 3G/3GS Adapter Sleeve (21041052) .............................................................. 20

B.4 iPod Touch 3rd and 4th Generation Adapter Clip (21041053) ................................. 21

B.5 iPad 2/3 Adapter Sleeve (21041054) .......................................................................... 22

B.6 iPad With Retina Display Adapter Sleeve (21041086) .............................................. 22

B.7 iPad Mini Adapter Sleeve (21041087) ......................................................................... 23

B.8 iPhone 5/5s Adapter Sleeve (21041088) .................................................................... 23

B.9 iPhone 5c Adapter Sleeve (21041136) ........................................................................ 24

B.10 iPod Touch 5th Generation Adapter Sleeve (21041089) ........................................ 24

B.11 iPad Air, iPad Mini 3, iPad Mini with Retina Display Adapter Sleeve (21041137)

25

B.12 iPad Air 2 Adapter Sleeve (1000001920) ................................................................ 25

B.13 iPhone 6 Adapter Sleeve (21041139) ...................................................................... 26

Page 7: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

1 - Table of Contents

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 7

B.14 iPhone 6 Plus Adapter Sleeve (21041140) .............................................................. 26

Appendix C Troubleshooting ..................................................................................................... 27

C.1 iDynamo Not Detected By App ....................................................................................... 27

C.2 Bad Reads / Swipe Not Detected ................................................................................... 27

C.3 iOS Device Not Charging .................................................................................................. 27

C.4 iOS Device Not Synchronizing ......................................................................................... 28

Page 8: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

1 - Introduction

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 8

1 Introduction

1.1 About iDynamo iDynamo™ is a compact secure card reader authenticator (SCRA) that reads magnetic stripes and

conforms to ISO standards. iDynamo is compatible with the iPad, iPhone, and iPod Touch products with

either 30-pin or Lightning interface options.

In addition to reading multiple tracks of data from a card, the reader incorporates MagnePrint®

technology, so a card’s unique MagnePrint fingerprint is included with the track data in each transaction.

To maximize card security, when a user swipes a card through the reader, the device encrypts card data

and MagnePrint data before they leave the encapsulated magstripe reading head using the Triple Data

Encryption Algorithm (TDEA, also known as Triple DES).

iDynamo manages encryption keys using DUKPT (Derived Unique Key Per Transaction) key

management. DUKPT uses a base derivation key to encrypt a key serial number that produces an initial

encryption key which is injected into the reader prior to deployment. After each transaction, the

encryption key is modified per the DUKPT algorithm so each transaction uses a unique key. Thus, the

data will be encrypted with a different encryption key for each transaction.

1.2 Product Features iDynamo features include:

iDynamo is compatible with iPad (2nd and 3rd generation), iPhone 3G, iPhone 4s, iPhone 4, iPhone

3GS, iPhone 3G, and iPod touch (3rd and 4th generation)

iDynamo 5 is compatible with iPad Air 2, iPad Air, iPad with Retina Display, iPad Mini 3, iPad Mini

with Retina Display, iPad Mini, iPhone 6 Plus, iPhone 6, iPhone 5s, iPhone 5c, iPhone 5, and iPod

touch (5th generation)

Pass-through Micro-USB port allows the iOS device to charge and synchronize without disconnecting

iDynamo [Lightning connector supports charge ONLY; iTunes synchronization is not available]*

iDynamo 5 uses Apple Lightning connector; legacy iDynamo uses Apple 30-pin connector

Bi-directional card reading

Reads encoded data that meets ANSI/ISO/AAMVA/JIS Type 2 standards

Reads up to three tracks of card data

Non-volatile memory for storage of protected and settable properties (such as unit serial number)

Provides 54 byte MagnePrint™ value

Contains a unique, permanent serial number for tracking

Encrypts track data MagnePrint values before they leave the reader head

Provides clear text confirmation data, including card holder’s name, expiration date, and a portion of

the PAN as part of the masked track data

Supports mutual authentication mode for use with Magensa.net

* iPad charging may require using the Apple supplied 10 Watt (2A @ 5V) iPad charger or equivalent.

Computer USB ports may not supply enough power to charge the device.

Page 9: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

1 - Introduction

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 9

1.3 Planning When planning an integrated solution that includes iDynamo, there are important questions which will

help determine which device, adapters, accessories, and infrastructure you choose:

Which iOS device will iDynamo be attached to? This informs which iDynamo model you need.

What electromechanical interface will you use to attach and interface iDynamo with the iOS device?

This informs which iDynamo model and which adapters you need.

What application(s) will you use to test the device? What application(s) will you use to process

transactions? This informs what additional software infrastructure you will need to put in place.

1.3.1 Choose an iDynamo Model

Use Table 2 to determine which model of iDynamo is appropriate for your solution:

Table 2 - iDynamo Model Selection

Model Part # Tracks Interface Compatible With

iDynamo 21073084 1,2,3 30-pin iPad (2nd and 3rd generation), iPhone 3G, iPhone

4s, iPhone 4, iPhone 3GS, iPhone 3G, and iPod

touch (3rd and 4th generation)

iDynamo 5 21073131 1,2,3 Lightning iPad Air 2, iPad Air, iPad with Retina Display,

iPad Mini 3, iPad Mini with Retina Display,

iPad Mini, iPhone 6 Plus, iPhone 6, iPhone 5s,

iPhone 5c, iPhone 5, and iPod touch (5th

generation)

1.3.2 Choose Adapters / Accessories

Use Table 3 to determine which adapters and / or accessories are appropriate for your solution. To help

with selection, the adapters are shown graphically in Appendix B.

Table 3 - Adapters and Accessories

Part Number Description Optional/Included

21041054 iPad 2/3 adapter sleeve Included with iDynamo

21041051 iPad adapter sleeve Included with iDynamo

21041052 iPhone 3G/3GS adapter sleeve Included with iDynamo

21041050 iPhone 4/4S adapter sleeve Included with iDynamo

21041053 iPod Touch clip (for use with 21041052) Included with iDynamo

21041086 iPad with Retina Display adapter sleeve Included with iDynamo 5

21041137 iPad Air, iPad Mini 3, iPad Mini with Retina

Display adapter sleeve

Included with iDynamo 5

1000001920 iPad Air 2 adapter sleeve Included with iDynamo 5

21041088 iPhone 5/5s adapter sleeve Included with iDynamo 5

21041139 iPhone 6 adapter sleeve Included with iDynamo 5

21041140 iPhone 6 Plus adapter sleeve Included with iDynamo 5

21041089 iPod Touch 5th generation adapter sleeve Optional

Page 10: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

1 - Introduction

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 10

21041087 iPad Mini adapter sleeve Optional

21041136 iPhone 5c adapter sleeve Optional

21051543 Retractable Micro-USB cable Optional

93600175 2’ 30-pin extension cable for use with iPad Optional

Page 11: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

2 - Installation

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 11

2 Installation

2.1 How to Install iDynamo and Software the First Time To connect iDynamo to your selected iOS device for the first time, follow these steps:

1) Power on the iOS device.

2) Select the appropriate iDynamo adapter sleeve as indicated in section 1.3.2 Choose Adapters /

Accessories, optionally using the dimensions and shapes shown in Appendix B for reference. For

iPod Touch 3rd Generation and 4th Generation, attach the iPod Touch clip to the iPhone 3G/3GS

sleeve, oriented so the appropriate iPod Touch generation name is visible. Refer to Appendix B

iDynamo Adapters for detailed illustrations.

3) Connect the adapter sleeve to the iDynamo.

4) Connect the adapted iDynamo to the iOS device. Make sure all components are seated firmly.

5) After a few seconds, the iOS device will pop up an “App Not Installed” window. Press the App

Store button to open the App Store and browse all compatible applications.

6) Select and install QwickPAY as you would any iOS app.

7) Run QwickPAY and follow the instructions found in the QwickPAY documentation.

Page 12: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

2 - Installation

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 12

2.2 How to Re-Install Software If the iDynamo has been installed on the device previously, but you want to trigger the process of re-

installing software, follow these steps:

1) Follow the steps in section 3.1 How to Check Device Status.

2) On the “Settings > General > About > iDynamo” page, select Find App for Accessory.

3) Select and install QwickPAY as you would any iOS app.

4) Run QwickPAY and follow the instructions found in the QwickPAY documentation.

Page 13: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

3 - Operation

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 13

3 Operation

3.1 How to Check Device Status To check the status of an iDynamo connected to an iOS device, follow these steps:

1) From the iOS device’s main screen, select Settings to open the Settings page.

2) In the left-side navigator (on iPad) or the main pane (on iPhone or iPod Touch), select General to

open the General page.

3) Select About> to open the About page.

4) Make sure there is an iDynamo or iDynamo5 entry in the list on the About page.

Page 14: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

3 - Operation

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 14

5) Select the device’s entry on the About page to show the device’s properties page. It should be

similar to Figure 3-1.

Figure 3-1 - iDynamo Properties Page

3.2 How to Set Up Charging and Synchronization iDynamo is equipped with a pass-through Micro-USB port which allows the connected iOS device to

continue charging and synchronizing* while iDynamo is connected.

To set up pass-through charging and synchronization*, follow these steps:

1) Disconnect iDynamo from the iOS device.

2) If charging and synchronizing* using a computer: Connect the iOS device directly to the computer’s

high-power USB port (2A @ 5V) using the iOS device’s original cable, and test to make sure the iOS

device charges and synchronizes* correctly.

1) If charging using an Apple-supplied or third-party charger designed for the device: Connect the iOS

device directly to the charger using iOS device’s original cable, and test to make sure the iOS device

charges correctly.

3) Disconnect the charging cable from the iOS device.

4) Connect iDynamo to the iOS device as described in section 2 Installation.

5) Connect the charging cable to iDynamo’s pass-through Micro-USB port.

* Note that when iDynamo is connected to the iOS device using the Lightning connector, the iOS device

can only charge through the Micro-USB port; it can not synchronize.

Page 15: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

3 - Operation

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 15

3.3 About Power Saving Mode When an app closes a session with a reader, the reader will go to low power mode until the app restarts or

re-initiates a session.

Page 16: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

4 - Developing Custom Apps

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 16

4 Developing Custom Apps iDynamo supports development of custom third-party apps. This section provides some information

pertinent to developing apps that are compatible with iDynamo. For further information, see these

reference documents, which are available from the MagTek documentation web site found at

http://www.magtek.com/support/documentation/documentation.asp:

iDynamo MagneSafe V5 Communication Reference Manual (D99875483)

Communication with iDynamo (a Made for iPhone External Accessory) (D99875555)

For more information about key management, see ANS X9.24-2004 Retail Financial Services

Symmetric Key Management Part 1: Using Symmetric Techniques

4.1 About Device Detection The iDynamo reader goes through an identification and authentication process each time it is attached to

an iOS device. After the process is successful, the reader becomes available to the operating system.

Apps can then open a communication channel to the reader and send commands to / receive responses

from the reader.

To set up a communications channel, the app will need the following two pieces of information:

SDK Protocol / Bundle Identifier = com.magtek.idynamo

Bundle Seed ID = a 10 character string assigned by Apple Inc. to the developer

For details about iOS app development, see https://developer.apple.com/devcenter/ios.

4.2 About Security iDynamo can be configured to require mutual authentication with an authentication / cryptographic host

before it will transmit card data. This functionality can be activated by the app.

4.3 About Card Reads After the iOS device identifies and authenticates the iDynamo, apps may open a session with it. A card

may be swiped through the reader slot. Encrypted data will be sent through the connector to the app,

which will then transmit it to a cryptographic host for decryption. Data may be sent in 2 blocks.

iDynamo is ready to read the next card immediately.

4.4 About States Apps can determine the state of the reader at any time using the Get Reader State command. As a

convention, this document refers to device states with the notation State:Antecedent (for example,

WaitActAuth:BadSwipe). State definitions can be found at the definition of the Get Reader

State command in the iDynamo MagneSafe Communication Reference Manual.

In most cases, the app can also infer a reader’s state. As the app interacts with a reader, most state

transitions are indicated by commands and responses. The one exception is the transition from

WaitActRply:x to WaitActAuth:TOAuth. This state transition occurs as the result of a timeout,

so it is not reported to the app. If the app sets a limited period of time for the reader to wait for the next

command, it should anticipate that a timeout could occur before it sends the Activation

Challenge Reply command. If the app sends the Activation Challenge Reply command

after the reader timeout occurs, the reader will return response code 07 (sequence error).

Page 17: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

4 - Developing Custom Apps

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 17

4.4.1 State Transitions Example: Power Up, Authentication, Good Swipe

1) Reader Powers Up (State = WaitActAuth:PU). App should send the Get Reader State

command to discover the current state of the reader.

2) App sends valid Activate Authenticated Mode command (State→WaitActRply:PU).

Reader returns response code 00 inferring the transition to the WaitActRply:PU state.

3) App sends valid Activation Challenge Reply command (State→WaitSwipe:PU).

Reader returns response code 00 inferring the transition to the WaitSwipe:PU state.

4) User swipes a card correctly (State→WaitActAuth:GoodSwipe). Reader sends encrypted card

data to the app inferring the transition to the WaitActAuth:GoodSwipe state.

4.4.2 State Transitions Example: Reader Timeout Waiting for Swipe

1) Reader waiting (State = WaitActAuth:GoodSwipe). This is after a good swipe. App may send

the Get Reader State command to discover the current state of the reader.

2) App sends valid Activate Authenticated Mode command

(State→WaitActRply:GoodSwipe). Reader returns response code 00 inferring the transition to

the WaitActRply:GoodSwipe state.

3) App sends valid Activation Challenge Reply command

(State→WaitSwipe:GoodSwipe). Reader returns response code 00 inferring the transition to the

WaitSwipe:GoodSwipe state.

4) Timer expires (State→WaitActAuth:TOSwipe). Reader returns empty card data to the app to

report the timeout (see Reader Encryption Status in iDynamo MagneSafe

Communication Reference Manual). App infers a transition to WaitActAuth:TOSwipe state.

4.4.3 State Transitions Example: App Sends Invalid Activation Challenge Reply Command

1) Reader Waiting (State = WaitActAuth:GoodSwipe). This is after a good swipe. App may send

the Get Reader State command to discover the current state of the reader.

2) App sends valid Activate Authenticated Mode command

(State→WaitActRply:GoodSwipe). Reader returns response code 00, inferring the transition to

the WaitActRply:GoodSwipe state.

3) App sends invalid Activation Challenge Reply command

(State→WaitActAuth:FailAuth). Reader returns response code 02 or 04 inferring the

transition to the WaitActAuth:FailAuth state.

4.4.4 State Transitions Example: Timeout Waiting for App’s Activation Challenge Reply

1) Reader Waiting (State = WaitActAuth:GoodSwipe). This is after a good swipe. App may send

the Get Reader State command to discover the current state of the reader.

2) App sends valid Activate Authenticated Mode command

(State→WaitActRply:GoodSwipe). Reader returns response code 00 inferring the transition to

the WaitActRply:GoodSwipe state.

3) Reader times out waiting for app to send Activation Challenge Reply command

(State→WaitActAuth:TOAuth). App doesn’t know because the reader can/does not send any

message.

4) App eventually sends Activation Challenge Reply command (state remains

WaitActAuth:TOAuth). Reader returns response code 07 inferring the previous transition to

WaitActAuth:TOAuth state.

Page 18: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix A - Technical Specifications

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 18

Appendix A Technical Specifications

Reference Standards

ISO 7810 and ISO 7811, AAMVA

Physical Characteristics

Dimensions (L x W x H)

without adapters:

2.47 in. x 1.50 in. x 0.58 in. (62.7 mm x 38.1 mm x 14.7 mm)

Weight without adapters: iDynamo = 1.03 oz.

iDynamo 5 = 1.02 oz.

Operational Characteristics

Acceptable Swipe Speeds: 6 in./s to 60 in./s (15 cm/s to 152 cm/s)

Electrical Characteristics

Voltage Requirements: 2.85 to 3.47 VDC from the attached device

Maximum Current Draw: 50 mA from the attached device

Data Ports: Apple 30-pin (Legacy iDynamo)

Apple Lightning (iDynamo 5)

Micro-USB (for pass-through charging / synchronization*)

Software Characteristics

Tested Operating System(s): iOS 6.0.0 through 6.1.3

Message Format: ASCII

Message Protocol: MagneSafe

Environmental Tolerance

Operating temperature: 0°C to 35°C (32°F to 95°F)

Operating relative humidity: 5% to 90% without condensation

Storage temperature: -20°C to 45°C (-4°F to 113°F)

Storage relative humidity: 5% to 90% without condensation

Maximum operating altitude: 3000 m (10,000 ft.)

* Note that when iDynamo is connected to the iOS device using the Lightning connector, the iOS device

can only charge through the Micro-USB port; it can not synchronize.

Page 19: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix B - iDynamo Adapters

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 19

Appendix B iDynamo Adapters

Figure 4-1 - iDynamo, iDynamo 5 Without Adapters

B.1 iPhone 4/4S Adapter Sleeve (21041050)

Figure 4-2 – iDynamo with iPhone 4/4S Sleeve, Sleeve Dimensions (in inches)

Page 20: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix B - iDynamo Adapters

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 20

B.2 iPad Adapter Sleeve (21041051)

Figure 4-3 – iDynamo with iPad Sleeve, Sleeve Dimensions (in inches)

B.3 iPhone 3G/3GS Adapter Sleeve (21041052)

Figure 4-4 – iDynamo with iPhone 3/3GS Sleeve, Sleeve Dimensions (in inches)

Page 21: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix B - iDynamo Adapters

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 21

B.4 iPod Touch 3rd and 4th Generation Adapter Clip (21041053) The iPod Touch 3rd and 4th Generation adapter is a clip added to the iPhone 3G/3GS adapter, oriented

such that the appropriate iPod Touch generation name is visible (see Figure 4-5).

Figure 4-5 – iDynamo with iPhone 3/3GS Sleeve and iPod Touch Clip (3rd and 4th Gen Configurations)

Figure 4-6 - iPod Touch Adapter Clip Dimensions (in inches)

Page 22: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix B - iDynamo Adapters

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 22

B.5 iPad 2/3 Adapter Sleeve (21041054)

Figure 4-7 – iDynamo with iPad 2/3 Sleeve, Sleeve Dimensions (in inches)

B.6 iPad With Retina Display Adapter Sleeve (21041086)

Figure 4-8 – iDynamo 5 with iPad With Retina Display Sleeve, Sleeve Dimensions (in inches)

Page 23: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix B - iDynamo Adapters

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 23

B.7 iPad Mini Adapter Sleeve (21041087)

Figure 4-9 – iDynamo 5 with iPad Mini Sleeve, Sleeve Dimensions (in inches)

B.8 iPhone 5/5s Adapter Sleeve (21041088)

Figure 4-10 – iDynamo 5 with iPhone 5 Sleeve, Sleeve Dimensions (in inches)

Page 24: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix B - iDynamo Adapters

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 24

B.9 iPhone 5c Adapter Sleeve (21041136)

Figure 4-11 – iDynamo 5 with iPhone 5c Sleeve, Sleeve Dimensions (in inches)

B.10 iPod Touch 5th Generation Adapter Sleeve (21041089)

Figure 4-12 iDynamo 5 with iPod Touch 5th Generation Sleeve, Sleeve Dimensions (in inches)

Page 25: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix B - iDynamo Adapters

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 25

B.11 iPad Air, iPad Mini 3, iPad Mini with Retina Display Adapter Sleeve

(21041137)

Figure 4-13 iDynamo 5 with iPad Air / iPad Mini 3 / iPad Mini with Retina Display Sleeve, Sleeve Dimensions

(in inches)

B.12 iPad Air 2 Adapter Sleeve (1000001920)

Figure 4-14 iDynamo 5 with iPad Air 2 Sleeve, Sleeve Dimensions (in inches)

Page 26: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix B - iDynamo Adapters

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 26

B.13 iPhone 6 Adapter Sleeve (21041139)

Figure 4-15 iDynamo 5 with iPhone 6 Sleeve, Sleeve Dimensions (in inches)

B.14 iPhone 6 Plus Adapter Sleeve (21041140)

Figure 4-16 iDynamo 5 with iPhone 6 Plus Sleeve, Sleeve Dimensions (in inches)

Page 27: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix C - Troubleshooting

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 27

Appendix C Troubleshooting Ergonomics also play a critical role. If something is impeding the end of the swipe and causes you to stop

short, or the reader is placed/held at an awkward angle, you will also generate a good deal of bad read

events. There are videos available that demonstrate proper swiping technique. The typical symptom for a

broken read head or circuit is a lack of any data from a swipe event, but a card swiped backwards or

upside down will also exhibit the same symptom.

C.1 iDynamo Not Detected By App If the app you are using won’t detect or connect to the device, check the following:

Check the electromechanical connection:

o Make sure the iOS device’s case is not interfering with the connection.

o Make sure you are using the correct adapter for the chosen iOS device (see Appendix B).

o Make sure the adapted iDynamo does not shift on the iOS device when gently wiggled.

o Make sure the reader’s connector is not damaged or dirty.

o Connect another device to the iOS device’s connector to make sure it is functioning correctly.

For an app to interface with the iDynamo, it must use the same Bundle Identifier as the device (by

default, com.magtek.idynamo). iDynamo can also be configured with a different Bundle

Identifier, in which case the app must use that Bundle Identifier instead.

C.2 Bad Reads / Swipe Not Detected If card swipes are not being registered correctly, check the following:

Card orientation. Make sure the card is oriented so the magstripe is inside iDynamo and facing

toward the thicker side of the iDynamo (away from the lock logo).

Damaged card. The magstripe on the card may be damaged. Try another card.

Excessive buildup on the read head. Clean the read head by swiping a cleaning card through the

iDynamo several times in different orientations until the card comes out clean. Cleaning cards are

available from MagTek as part number 96700025. If the operation environment is dusty, use

compressed air to blow residue out of the iDynamo.

Swipe mechanics. A good read depends on the magstripe moving straight over the read head and

above a certain speed. Try swiping more quickly and straight through the guide path of the iDynamo.

The range of working swipe speeds is listed in Appendix A Technical Specifications.

Ergonomics. Make sure there are no mechanical hindrances (such as an accessory case or stand for

the iOS device) to swiping quickly and straight through the device.

EDGE protocol. When iDynamo is used with an iPhone using EDGE protocol for wireless

communication, the reader may encounter too much electromagnetic interference to work reliably. In

these cases, it may take multiple swipes to obtain the track data and a reliable MagnePrint reading.

If iDynamo is still not registering swipes after following these steps, contact your supplier for assistance.

C.3 iOS Device Not Charging If the connected iOS device is not charging through the pass-through Micro-USB port, check the

following:

Incorrect power supply / not enough power: Swap out components in the chain, such as the power

supply itself and the cable connecting the power supply to iDynamo. Remove iDynamo and connect

the power supply directly to the iOS device to make sure the device charges.

Page 28: MagneSafe Secure Card Reader Authenticator … · MagneSafe Secure Card Reader Authenticator ... iPhone®, iPod®, ... repair or replace this product at no additional charge except

Appendix C - Troubleshooting

iDynamo| MagneSafe Secure Card Reader Authenticator | Installation and Operation Manual

Page 28

Check the connectors on iDynamo, the iOS device, and cable to make sure they are not dirty or

damaged.

C.4 iOS Device Not Synchronizing If the connected iOS device is not synchronizing through the pass-through Micro-USB port, check the

following:

Be aware that iOS devices cannot synchronize through iDynamo using the Apple Lightning

connector. They can only charge.

Follow the troubleshooting procedures in section C.3 iOS Device Not Charging.