MagTek EC2000 99875713 User Manual

ExpressCard 2000

Instant Issuance Card Personalization System

Programmer’s Reference (Windows SDK)

August 2014

Manual Part Number:

99875713-1.01

REGISTERED TO ISO 9001:2008

MagTek I 1710 Apollo Court I Seal Beach, CA 90740 I Phone: [phone] I Technical Support: [phone]

www.magtek.com

0 - Table of Contents

Rev Number

Date

Notes

1.01

August 8, 2014

Initial Release from content in 99875367, 99875611 draft

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.
ExpressCard 2000 is a trademark of MagTek, Inc.

Microsoft® and Windows® are registered trademarks of Microsoft Corporation.

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

Table 0-1 - Revisions

ExpressCard 2000| Instant Issuance Card Personalization System | Programmer’s Reference (Windows SDK)

Page 2 of 21

0 - Table of Contents

SAFETY

This product has been evaluated by multiple safety certification agencies, including
Underwriters Laboratories (UL) and the United States Federal Communications
Commission (FCC Class A and Class B), and is designed to protect both the user and the
device. This document is written specifically to work in conjunction with these safety and
integrity features to protect the user and the device. It is very important to follow all steps
in the product documentation carefully, in the order in which they are described, and at
the recommended times. Failure to do so could result in personal injury, and / or cause
damage to the device, and / or void the product warranty.

SAFETY REQUIREMENTS

Caution: Never do any of the following:

 DO NOT use a ground adapter plug to connect equipment to a power receptacle that lacks a ground

connection terminal.

 DO NOT attempt any maintenance procedure that is not specifically described in this manual or any

other MagTek ExpressCard 2000 manual.

 DO NOT remove any of the covers or guards that are fastened with screws. There are no operator-

serviceable areas within these covers.

 DO NOT override or “cheat” electrical or mechanical interlock devices.
 DO NOT use supplies or cleaning materials for other than their intended purposes.
 DO NOT operate the device if you or anyone else has noticed unusual noises or odors.

Consider the following before operating the ExpressCard 2000:

 Connect equipment to a properly grounded power source receptacle. If in doubt, have the receptacle

checked by a qualified electrician. Improper connection of the equipment’s grounding conductor
creates a risk of electric shock.

 Only place the device on a solid surface that can safely support the device’s weight.
 Be careful when moving or relocating the device. Use proper lifting techniques.
 Use materials and supplies specifically designed for MagTek equipment. Using unsuitable materials

can cause poor performance, and in some cases may be hazardous, cause damage, and / or void the
device’s warranty.

ExpressCard 2000| Instant Issuance Card Personalization System | Programmer’s Reference (Windows SDK)

Page 3 of 21

1 - Table of Contents

Table of Contents

Table of Contents ............................................................................................................................... 4

1 Introduction ................................................................................................................................. 5

1.1 Product Summary ............................................................................................................... 5

1.2 About Communicating With EC2000 .............................................................................. 6

1.3 About mtecsdk.dll ............................................................................................................... 6

1.4 How to Use the ExpressCard SDK in Software Projects ................................................ 6

1.5 How to Set Up the ExpressCard SDK for Runtime ......................................................... 7

1.6 How to Debug the API ........................................................................................................ 9

1.7 How to Send a Transaction ................................................................................................ 9

2 Functions .................................................................................................................................... 10

2.1 MTECSDK_GetDevice ....................................................................................................... 10

2.2 MTECSDK_OpenDevice .................................................................................................... 11

2.3 MTECSDK_SetLogFileHandle .......................................................................................... 11

2.4 MTECSDK_LogEnable ....................................................................................................... 12

2.5 MTECSDK_SetValue .......................................................................................................... 13

2.6 MTECSDK_SetAttribute .................................................................................................... 14

2.7 MTECSDK_ProcessDoc ..................................................................................................... 15

2.8 MTECSDK_GetValue ......................................................................................................... 16

2.9 MTECSDK_GetAttribute .................................................................................................... 18

2.10 MTECSDK_QueryInfo .................................................................................................... 19

2.11 MTECSDK_SendCommand .......................................................................................... 20

2.12 MTECSDK_CloseDevice ................................................................................................ 20

ExpressCard 2000| Instant Issuance Card Personalization System | Programmer’s Reference (Windows SDK)

Page 4 of 21

1 - Introduction

1 Introduction

This manual is for programmers who wish to develop custom card personalization software that can
communicate with ExpressCard 2000 (EC2000) devices. It begins with an introduction to the EC2000
device and supporting software architecture, then provides syntax for available operations.

1.1 Product Summary

ExpressCard 2000 (EC2000) is a compact instant-issuance card personalization device (CPD) that can
securely, fully personalize any CR80-sized credit, debit, ATM, gift, loyalty, or membership card in as
little as 90 seconds.

ExpressCard 2000 is supported by QwickCards.com and a wide range of third-party software solutions,
creating a complete, secure instant issuance system for distributed locations that can be maintained and
controlled centrally. With the feature-rich solution offered by EC2000, financial institutions will be able
to meet current market needs and also support new card issuance trends, including smart cards,
contactless cards, flat cards, and photo cards.

EC2000 uses the security of MagTek’s advanced MagneSafe™ Security Architecture, and MagnePrint®

card authentication technology for magstripe encoding. ExpressCard 2000’s physical and logical security

features exceed compliance requirements for instant issuance published by Visa® and MasterCard®.

EC2000’s MagnePrint Reference Capture Module captures and registers each card’s unique MagnePrint®
signature as it is issued. This registered signature can then be used to protect legitimate cardholders by
validating that the card being used at an ATM, teller window, home banking, or POS location is
authentic, not a counterfeit copy.

Product features include:

 Touchscreen LCD display
 Seven card stock hoppers (100 cards per hopper)
 Manual feed slot (single card processing)
 Magstripe encoding with MagnePrint® card authentication technology
 smart card encoding (contact only)
 Full-color image printing (two-sided)
 Embossing
 Foil tipping
 Rear indent printing
 Ethernet interface
 Secure enclosure with key or touchscreen unlock
 Physical and logical security features that exceed compliance requirements for instant issuance

published by Visa® and MasterCard®.

 Card issuance supported by QwickCards.com and third-party solutions
 Card issuance supported from third-party software using XML key-value pairs

For detailed information about the EC2000 device from the user perspective, see the ExpressCard 2000
User Installation and Operation Manual, available from MagTek.

ExpressCard 2000| Instant Issuance Card Personalization System | Programmer’s Reference (Windows SDK)

Page 5 of 21

1 - Introduction

File

Location

Description

mtecsdk.ini

C:\Windows

This file contains a list of default ExpressCard
connections and IP addresses. This file is required
by mtecsdk.dll.

1.2 About Communicating With EC2000

EC2000 is a networked device which receives transactions from card personalization software in the form
of HTTPS requests sent to specific URLs in its internal web server, using XML formatted according to a
specification developed by MagTek. Developers of card personalization software have two options for
generating these HTTPS requests in their custom software:

 They can construct XML and send HTTPS requests directly.
 They can use the MagTek ExpressCard SDK provided in mtecsdk.dll.

Both options provide the same set of features, and from the device’s perspective both methods are
practically identical, apart from possible deviations in the exact XML format and content. The advantage
of using the ExpressCard SDK is that it abstracts implementation details, such as the physical connection
to the device and the creation and structure of the transaction XML. This abstraction can reduce the
overall maintenance cost of custom card personalization software.

This document serves primarily as a reference for the second method (constructing requests using the
MagTek ExpressCard Windows SDK), which requires 33090060 ExpressCard Software Development

Kit, available from MagTek. For information about sending XML requests directly, see 99875611
ExpressCard 2000 Programmer’s Reference (XML), available from MagTek.

1.3 About mtecsdk.dll

mtecsdk.dll provides a high-level API to communicate with the device. It completely encapsulates
calls to msxml4.dll to convert transactions into XML, as well as calls to wininet.dll for network
communication. mtecsdk.dll also provides functions to convert the XML responses from the device
into key-value pairs that can be easily retrieved without parsing the XML.

1.4 How to Use the ExpressCard SDK in Software Projects

To use the ExpressCard SDK in a custom software project, follow these steps:

1) Download 33090060 ExpressCard Software Development Kit (SDK), available from MagTek.

2) Run the setup program to install the SDK on your development workstation, noting the full

installation directory path. By default, the SDK installs to C:\Program Files
(x86)\MagTek\ExpressCard (SDK) Demo, and supporting files install to various other Windows
library locations.

3) Ensure the files listed in Table 1-1 have successfully been copied to the specified locations.

4) Create or open your custom software project in Visual Studio.

5) If your chosen programming language links using .h files, include mtecsdk.h located in the root

installation location of the ExpressCard SDK.

6) If your chosen programming language links using .lib files, include mtecsdk.lib located in the root

installation location of the Expresscard SDK.

7) If your chosen programming language links directly to .dll files, include mtecsdk.dll located in

C:\Windows\SysWOW64 on 64-bit workstations or C:\Windows \System32 on 32-bit workstations.

Table 1-1 - Files Required for ExpressCard SDK

ExpressCard 2000| Instant Issuance Card Personalization System | Programmer’s Reference (Windows SDK)

Page 6 of 21

1 - Introduction

File

Location

Description

mtecsdk.dll

C:\Windows\System32

ExpressCard API.

wininet.dll

C:\Windows\System32

Win32 API for Internet Protocols. This file is
provided by Microsoft.

msxml4.dll

C:\Windows\System32

MSXML XML parser. ActiveX Object for XML
API . This file is installed with the installation of
ExpressCard 1000 API.

1.5 How to Set Up the ExpressCard SDK for Runtime

To set up the ExpressCard SDK for runtime use with the ExpressCard Demo software or any custom
software, follow these steps on the host where the software is installed:

1) Install the ExpressCard SDK by following the steps in section 1.4 How to Use the ExpressCard

SDK.

2) Determine the IP address of the device you want to connect to. For details, see the Configuration

section of 99875600 ExpressCard 2000 User Installation and Operation Manual. Alternatively,
if the device is registered with a DNS server, you can use the device’s registered IP name.

3) Ping the device from a command prompt to make sure there is a network route from the workstation

to the device.

4) Launch Notepad from the Windows Start menu in administrator mode by right-clicking its shortcut

and selecting Run as administrator.

5) Open C:\Windows\mtecsdk.ini in Notepad.

6) Edit the ConnectionString= line to change the IP address in the sections for both [DEVICE1] and

[DEVICE2], then save and close the file. If you can not save your changes, double-check that you
have launched Notepad in administrator mode.

7) Launch Start > All Programs > MagTek> ExpressCard (SDK) Demo.

8) To connect to the device, select the Create Card tab, select the device you want to connect to in the

Device Name dropdown list, and press the Open Device button. The main text area should report
Device: [Device Name] Opened Successfully (see Figure 1-1).

9) Use the various features in the Demo application to operate the device.

ExpressCard 2000| Instant Issuance Card Personalization System | Programmer’s Reference (Windows SDK)

Page 7 of 21