background image

4 - MTSCRA Library Data Type and Structures  

 

Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) 

 
Page 25 

*/ 

4.6

 

ARQC 

getTransactionProgress will return the ARQC after device request a acquirer decision for a transaction. 
type : 771 (0x303) 
data :  hex string contains byte array for following structure 

Offset 

Field 

Name 

Value 

Message 
Length 

Two byte binary, most significant byte first.  This gives the total length of the 
ARQC message that follows. 

ARQC 
Message 

See Appendix A.  It is expected that the host will use this data to process a 
request. 

 

{"type":771,"data":"01ABFD8201A7DFDF250F423330364639363039323831354141
FA8201909A030000009F02060000000009999F10120110A00001220000000000000000
000000FF9F1607303030303030309F4E0730303030303030820258008E100000000000
00000042015E0342031F035F24031401315F25031201019F0607A00000000410109F07
02FF009F0D05F0500408009F0E0500008800009F0F05F0700498009F260816A2BD071A
D5DC1E9F2701809F360200C59C01009F33032028C89F34035E03009F37049FA41BDA9F
3901059F4005720000B001950542200080009B02E8009F1E0842333036463936209F1A
0208405F2A0208409F01060000000000019F2103183917DFDF4D263B35343133303030
3034303030313531333D303131343030303030303030303030303030303FDFDF520105
F8820078DFDF560A9010010B306F9600001BDFDF570100FA820061DF31182E6ECDA60D
8CB9D382EE13942C18B6DF82EE13942C18B6DFDF321040A47A243903C9DA71DBF06996
3D1D64DF3B30E5B2E54BF31D8DC0BA5C217F756F0CC3D24553AE6B25BD4FFA7C8D9824
3DC66D8C43FEA072300044F6278B858108B825"}; 

4.7

 

Transaction Result 

getTransactionProgress will return the transaction data after device complete a transation 
type : 772 (0x304) 
data :  hex string contains byte array for following structure 

Offset 

Field 

Name 

Value 

Signature 
Required 

This field indicates whether a card holder signature is required to complete the 
transaction: 

 

0x00 – No signature required 

 

0x01 – Signature required 

 
If a signature is required, it is expected that the host will acquire the signature 
from the card holder as part of the transaction data. 

Batch Data 
Length 

Two byte binary, most significant byte first.  This gives the total length of the 
ARQC message that follows. 

Batch Data 

See Appendix C.  It is expected that the host will save this data as a record of 
the transaction. 

 

Summary of Contents for DYNAMAG

Page 1: ...A 90740 I Phone 562 546 6400 I Technical Support 888 624 8350 www magtek com Dynamag DynaMAX and eDynamo Secure Card Reader Authenticator Programmer s Reference WCF November 2015 Manual Part Number D9...

Page 2: ...e 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 per...

Page 3: ...reement are automatically terminated COPYRIGHT The Software is copyrighted Licensee may not copy the Software except for archival purposes or to load for execution purposes All other copies of the Sof...

Page 4: ...all inure to the benefit of MagTek Incorporated its successors or assigns ACKNOWLEDGMENT LICENSEE ACKNOWLEDGES THAT HE HAS READ THIS AGREEMENT UNDERSTANDS ALL OF ITS TERMS CONDITIONS AND RESTRICTIONS...

Page 5: ...Demo 9 2 2 1 Connect web service in C Project 9 2 2 2 Connect ajax service in web page javascript 11 2 3 How to Connect DynaMAX or eDynamo to a Windows Host via BLE 11 3 MTSCRA Library Functions 16 3...

Page 6: ...4 4 5 User Selection Request 24 4 6 ARQC 25 4 7 Transaction Result 25 Appendix A TLV Data Format 27 A 1 ARQC Message Format 27 A 2 ARQC Response from online processing 27 A 3 Transaction Result Messag...

Page 7: ...l terms device and host are used in different often incompatible ways in a multitude of specifications and contexts For example host may have different meanings in the context of USB communication tha...

Page 8: ...ework 4 5 installed Tested development environments Windows 8 1 with Microsoft Visual Studio 2013 1 5 Interfaces for Operating Systems The following table matches the device interface to operating sys...

Page 9: ...bit machine launch Visual Studio 2013 and open C Program Files x86 MagTek SCRA Windows SDK Sample Code CPP Source VCDemo vcxproj 2 For 32 bit machine launch Visual Studio 2013 and open C Program File...

Page 10: ...ow to Set Up the MagTek SCRA Libraries Dynamag DynaMAX and eDynamo Secure Card Reader Authenticator Programmer s Reference WCF Page 10 3 Input the base address to reference the WCF service then click...

Page 11: ...sert ScriptManager object asp ScriptManager ID ScriptManager1 runat server asp ScriptManager This step will enable the microsoftajax js module 4 Insert javascript referent to WCF script src http local...

Page 12: ...ynaMAX s batteries are installed and have adequate charge If using eDynamo make sure the device has an adequate charge 4 Test the batteries by powering on the DynaMAX or eDynamo device Provided the de...

Page 13: ...ttom of the device Note the final four digits 10 Read through the list of pairable devices and locate the device called DynaMAX nnnn or eDynamo nnnn where nnnn is the last four digits of the device s...

Page 14: ...asscode 000000 or the device s actual password if it has been configured differently then press the Next button Windows will return you to the Manage Bluetooth devices page After a short period of tim...

Page 15: ...ext editor 14 The device consumes very little power when not transmitting card data so it is not necessary to power off the device to conserve power If the device appears as Not connected in the Windo...

Page 16: ...elimited by If input is empty string or null means search all types Return Value A string with Devices URIs delimited by 3 2 getSDKVersion Retrieves SDK version string getSDKVersion Return Value The v...

Page 17: ...mmand to device and returns the raw response from device string sendCommand string Command Parameter Description Command Hex string for command It does not include the length of command data Reference...

Page 18: ...ard choose a language choose an application and online processing If this time is exceeded the transaction will be aborted and an appropriate Transaction Status will be available Value 0 is not allowe...

Page 19: ...ro mode This single byte field indicates the level of Transaction Status notifications the host desires to receive during the course of this transaction 0x00 Termination Status only normal termination...

Page 20: ...lection 0x00 User Selection Request completed see Selection Result 0x01 User Selection Request aborted cancelled by user 0x02 User Selection Request aborted timeout selection Indicates the menu item s...

Page 21: ...onse data First two bytes indicate message length following TLV response message Reference to A 2 ARQC Response Return Value This function will always returns null To get the result code of this comma...

Page 22: ...1d8 33e10070ba62f8d274fe55abee8855971364f716f4fa7d6fae47d078c7c98e7a220b84 4b127cc769344dc76bc14e3cf1638da8c4428daff38163b429037e8f80bc099e123f42 8fc06fb47743f8eeb633ba523a07 B9812000080006827 LAST FI...

Page 23: ...t complete within this time it will be aborted 2 Current Transaction Progress Indicator This one byte field indicates the current processing stage for the transaction 0x00 No transaction in progress 0...

Page 24: ...selection request this is 0x00 Application Selection 0x01 Language Selection Others TBD 1 Timeout Specifies the maximum time in seconds allowed to complete the selection process If this time is exceed...

Page 25: ...5720000B001950542200080009B02E8009F1E0842333036463936209F1A 0208405F2A0208409F01060000000000019F2103183917DFDF4D263B35343133303030 3034303030313531333D303131343030303030303030303030303030303FDFDF52010...

Page 26: ...700498009F2608C4751D62AEA184A59F270140 9F360200C59C01009F33032028C89F34035E03009F37049FA41BDA9F3901059F400572 0000B001950542200080009B02E8009F1E0842333036463936209F1A0208405F2A0208 409F010600000000000...

Page 27: ...d Tag 9F1F TLV T1 DD len val DF36 Encrypted Tag 9F20 TLV T2 DD len val DF37 Encrypted Tag 9F61 TLV T2 CVC3 len val DF38 Encrypted Tag 9F62 TLV T1 PCVC3 len val DF39 Encrypted Tag DF812A TLV T1 DD len...

Page 28: ...chant Data tags F8 len container tag for encrypted data DFDF56 Encrypted Transaction Data KSN len val DFDF57 Encrypted Transaction Data Encryption Type val FA len container for generic data DF30 Encry...

Page 29: ...List wcf getDeviceList Console WriteLine devList var devs devList Split foreach var dev in devs Console WriteLine dev var open wcf openDevice devs 0 Console WriteLine open devs 0 open if open 0 wcf cl...

Reviews: