background image

ID TECH VP3350 User Manual 

 

Page | 22  

Terminal Data List Example 

Data 

ID 

Tag 

Value name 

Length 

(Byte) 

Data 

5F36 

Transaction currency exponent 

02 

9F1A 

Terminal county code 

08 40 

9F35 

Terminal type 

21 

9F33 

Terminal capability 

60 28 C8 

9F40 

Additional terminal capability 

F0 00 F0 A0 01 

9F1E 

IFD serial number 

54 65 72 6D 69 6E 

61 6C 

9F15 

Merchant category code 

12 34 

9F16 

Merchant identifier 

15 

30 30 30 30 30 30 
30 30 30 30 30 30 

30 30 30 

9F1C 

Terminal identification 

38 37 36 35 34 33 

32 31 

10 

9F4E 

Merchant name and location 

<=64 

31 30 37 32 31 20 
57 61 6C 6B 65 72 
20 53 74 2E 20 43 
79 70 72 65 73 73 
2C 20 43 41 20 2C 

55 53 41 2E 

11 

DF26 

Terminal supports CRL 

01 

12 

DF10 

Language 

Var. up to 

128 

65 6E 66 72 65 73 

7A 68 

13 

DF11 

Support transaction log 

00 

14 

DF27 

support exception file 

00 

15 

DFEE15 

Terminal support ASI 

01 

16 

DFEE16 

Terminal encrypt mode 

00 

17 

DFEE17 

Terminal entry mode for ICC 

07 

18 

DFEE18 

Terminal encrypt mode for MSR 

80 

19 

DFEE1E 

Contact terminal configuration 

D0 DC 20 D0 C4 1E 

16 00 

20 

DFEE1F 

Issuer script limit 

80 

21 

DFEE1B 

ARC define 

30 30 30 31 35 31 

30 30 

22 

DFEE20 

ICC power on detect waiting time 

3C 

23 

DFEE21 

ICC L1 waiting time 

0A 

24 

DFEE22 

Driver waiting time. byte 1 -> Menu. byte 2 -> Get PIn. 
byte 3 -> MSR 

32 3C 3C 

 
The Contact Common EMV L2 comes with four approved configurations as shown below (1C, 2C, 3C, 
4C); these correspond to the scenarios defined by EMVCo in tag 9F35. Parameters marked as Major 
Parameters usually cannot be changed without causing a checksum error, although certain flag bits 
(see tables below) can be changed. The Major Parameters are considered read-only because these 
are the settings the device was certified with for EMV L2 certification. 
 

Terminal configuration 

Identification 

Tag 

1C 

2C 

3C 

4C 

Major 
parameters 

9F33 

60 F8 C8 

60 28 C8 

60 D8 C8 

60 08 C8 

9F35 

22 

21 

25 

25 

9F40 

F0 00 F0 A0 01 

F0 00 F0 A0 01 

60 00 F0 50 01 

60 00 F0 50 01 

DF11 

01 

00 

01 

01 

DF26 

01 

01 

01 

01 

DF27 

00 

00 

00 

00 

DFEE1E 

F0 DC 3C F0 C2 
9E 96 00 

D0 DC 20 D0 C4 
1E 16 00 

F0 DC 24 F0 C2 
0E 16 00 

D0 9C 20 F0 C2 
0E 16 00 

 
 

Содержание ViVOpay VP3350

Страница 1: ...Street Cypress CA 90630 4720 Tel 714 761 6368 Fax 714 761 8880 www idtechproducts com ViVOpay VP3350 Integration Manual 80178501 001 Rev B 17 March 2021 Copyright 2021 ID TECH All rights reserved ID TECH 10721 Walker Street ...

Страница 2: ...could void the user s authority to operate the equipment Note This equipment has been tested and found to comply with the limits for a Class B digital device pursuant to part 15 of the FCC Rules These limits are designed to provide reasonable protection against harmful interference in a residential installation This equipment generates uses and can radiate radio frequency energy and if not install...

Страница 3: ...Do not attempt to replace the internal rechargeable lithium ion battery Replacing the original battery with an incompatible type may result in an increased risk of personal injury or property damage due to explosion excessive heat or other risks Do not attempt to disassemble or modify the battery pack Attempting to do so can cause a harmful explosion or battery fluid leakage When disposing of the ...

Страница 4: ...MO APP 12 6 1 Using the Demo Application 12 7 VP3350 LOW LEVEL COMMANDS 13 7 1 Activate Transaction Command 02 40 13 7 2 Set CA Public Key D0 03 14 7 3 Get Processor Type 09 02 15 7 4 Get Main Firmware Version 09 03 16 7 5 Get Hardware Information 09 14 16 7 6 Get Module Version Information 09 20 18 7 7 Get Serial Number 12 01 19 7 8 Contact Set ICS Identification 60 16 20 7 9 Contact Set Terminal...

Страница 5: ...h BLE Bluetooth Low Energy Bluetooth communication supports iOS and Android platforms Communicates to iOS host devices via Lightning connector USB C connector supports battery charging or communication with Android or Windows host systems Rechargeable battery no external power necessary Supports pass through charging ICC EMV Level 1 Contact certified and integrated ID TECH s EMV L2 Gen 2 Common Co...

Страница 6: ...e Li Battery specification Storage Temperature 20 C to 60 C or 4 F to 140 F Non condensing Product storage temperature is limited to this range due to constraints of theLi Battery specification Operating Humidity Up to 95 Non condensing Storage Humidity Up to 95 Non condensing 2 4 Power Consumption Minimum 800 MSR transaction per charge with 30 second interval Minimum 400 contactless transactions ...

Страница 7: ...s and tablets Lightning connectors communicate with popular mobile iOS devices Bluetooth connection supports both Android and iOS USB A to micro USB allows communication to an Android or Windows host or allows for pass through charging to the host device When communicating over USB the VP3350 s default emulation mode is USB HID the unit can also emulate a USB HID KB interface Additionally Bluetoot...

Страница 8: ...vice named IDTECH VP3350 XXXXX on the host smart phone or tablet and select Pair 5 Enter the password for pairing The default password is 123456 6 Follow the payment transaction instructions provided by a compatible payment application maker to complete a transaction The VP3350 will remain connected via Bluetooth to the host device indefinitely when powered via the USB cable If the unit is operati...

Страница 9: ...d USB to USB C cable 4 2 VP3350 LED and Sound State Indicators The VP3350 uses the following LEDs and sounds to indicate various statuses including power management Bluetooth transactions and security Device State LED1 LED2 LED3 LED4 Sound Battery charging full on on on on None Battery power 20 on off off off None Bluetooth searching Pairing blink blink blink blink None Bluetooth connected on on o...

Страница 10: ...t not function with a payment app Unlike other operating systems that can detect or specify a BLE device by its MAC address Apple does NOT allow users to specify a BLE device by MAC address for security reasons Instead after a device is selected by its friendly name see the next paragraph the Apple iOS calculates a unique identifier to allow any that device to make further connections directly The...

Страница 11: ...like C or Java using convenience objects and data structures defined in the Universal SDK obviating the need to send byte commands directly Nevertheless it is possible to communicate with the device at a low level if necessary For a command reference for VP3350 request the NEO Interface Developers Guide IDG P N 80139403 001 This document includes not only low level firmware commands but error code...

Страница 12: ... device with a USB to micro USB cable not included 2 Double click the UniversalSDKDemo exe file and allow a few seconds for the main window to appear see illustration below The Universal SDK Demo app displays VP3350 s available commands in a command tree as shown above Single click on a command to populate the center panel of the window with optional settings relevant to the command for example Am...

Страница 13: ...ine the type of interface to be activated with 02 40 Interface selection Bit 0 MSR Bit 1 Contactless Bit 2 Contact DF EF 37 01 07 07 0000 0111 This activates transaction for all 3 interfaces DF EF 3C 03 Fallback support and Timeout value for waiting for the next command mainly to support EMV workflow Byte 1 Fallback support 0x00 not support fallback 0x01 support fallback Byte 2 3 Timeout for next ...

Страница 14: ...description 7 2 Set CA Public Key D0 03 The Set CA Public Key command adds a new key to the reader Command Frame Byte 0 9 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14 18 Byte 19 Bytes 19 n Byte n 1 Byte n 2 Header Tag Protocol Version Cmd Sub Cmd Length MSB Length LSB RID 5 bytes Key Index 1 byte Key Data CRC LSB CRC MSB ViVOtech2 0 D0h 03h varies varies varies varies See below Varies Varies Key Data i...

Страница 15: ...g 0xDF61 Length 0x02 Value a field representing the processor type The following types of processors may be identified in the Value field Processor Type hex values Description 45 00 ARM7 LPC21xx 4D 00 ARM Cortex M4 K21 Family 4E 00 ARM Cortex M4 K81 Family Byte 0 9 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14 Byte 15 Header Tag Protocol Command Sub Command Data Length MSB Data Length LSB CRC LSB CRC MS...

Страница 16: ...0 00 14 DF 62 11 43 72 61 6E 65 56 65 6E 64 69 5F 31 2E 30 2E 30 00 E1 5D 7 5 Get Hardware Information 09 14 The Get Hardware Information command retrieves information about the reader s hardware Command Frame Response Frame Byte 0 9 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14 Byte 15 Header Tag Protocol Command Sub Command Data Length MSB Data Length LSB CRC LSB CRC MSB ViVOtech2 0 09h 03 00h 00h Byt...

Страница 17: ... the hardware version information subcommand and the information being returned in ASCII format Command Get Hardware Version Information 56 69 56 4F 74 65 63 68 32 00 09 14 00 00 33 08 Response For example a VP5300 returns 5669564f7465636832000900001548572c205650353330300d0a4b38314620526576 3477d5 In ASCII HW VP5300 CR LF K81F Rev4 Byte 0 9 Byte 10 Byte 11 Byte12 Byte 13 Byte 14 Byte 13 n Byte 14 ...

Страница 18: ...0A 20 43 4C 20 41 49 44 2C 4D 61 73 74 65 72 43 61 72 64 20 50 61 79 50 61 73 73 20 4D 2F 43 68 69 70 20 76 33 2E 30 2E 32 2C 20 56 65 6E 64 69 20 76 31 2E 30 2E 30 2C 2C 0D 0A 20 43 4C 20 41 49 44 2C 56 69 73 61 20 56 43 50 53 20 32 2E 31 2E 33 2C 20 76 30 2E 39 39 2C 2C 0D 0A 20 43 4C 20 41 49 44 2C 41 6D 65 78 20 45 78 70 72 65 73 73 50 61 79 20 33 2E 30 2C 20 76 31 2E 30 30 2C 2C 0D 0A 20 43 4...

Страница 19: ...command frame is not valid the reader returns an error response frame Command Frame Byte 0 9 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14 Byte 15 Header Tag Protocol Version Command Sub Command Data Length MSB Data Length LSB CRC LSB CRC MSB ViVOtech2 0 12h 01h 00h 0Fh The serial number will be returned tail padded with 0x00 to a length of 15 Example TX 56 69 56 4F 74 65 63 68 32 00 12 01 00 00 18 A5 R...

Страница 20: ...5343332319f4e2231303732312057616c6b65 722053742e20437970726573732c204341202c5553412edf260101df1008656e6672 65737a68df110101df270100dfee150101dfee160100dfee170107dfee180180dfee 1e08f0dc24f0c20e1400dfee1f0180dfee1b083030303135313030dfee20013cdfee 21010adfee2203323c3caa88 Reader responds with 5669564f746563683200600000003d35 Success Command Frame Byte 0 9 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14 Byte ...

Страница 21: ... Header Tag Protocol Version Command Sub Command Data Length MSB Data Length LSB Data CRC LSB CRC MSB ViVOtech2 0 60h 06h Data Objects Data Objects TagCounterL TagCounterH TLV1 TLV2 TLVn Where TagCounterL TagCounterH the Number of TLV tags Response Frame Byte 0 9 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14 Byte 14 n 1 Byte 14 n Byte 15 n Header Tag Protocol Version Command Status Code Data Length MSB ...

Страница 22: ...DFEE18 Terminal encrypt mode for MSR 1 80 19 DFEE1E Contact terminal configuration 8 D0 DC 20 D0 C4 1E 16 00 20 DFEE1F Issuer script limit 1 80 21 DFEE1B ARC define 8 30 30 30 31 35 31 30 30 22 DFEE20 ICC power on detect waiting time 1 3C 23 DFEE21 ICC L1 waiting time 1 0A 24 DFEE22 Driver waiting time byte 1 Menu byte 2 Get PIn byte 3 MSR 3 32 3C 3C The Contact Common EMV L2 comes with four appro...

Страница 23: ...FU x x x x x x 0 x RFU x x x x x x X 0 RFU Byte 3 b8 b7 b6 b5 b4 b3 b2 b1 Meaning Change 1 x x x x x x x SDA Major X 1 x x x x x x DDA Major X x 1 x x x x x Card capture x x x 0 x x x x RFU x x x x 1 x x X CDA Major x x x x x 0 x x RFU x x x x x x 0 x RFU x x x x X X x 0 RFU 3 9F35 Terminal Type Environment Financial Institution Merchant Cardholder Change Attended Online only Offline with online c...

Страница 24: ... x x Print cardholder x x 1 x x x x x Display attendant x x x 1 x x x x Display cardholder x x x x 0 x x x RFU x x x x x 0 x x RFU x x x x x x 1 x Code table 10 Major x x x x x x x 1 Code table 9 Major Byte 5 b8 b7 b6 b5 b4 b3 b2 b1 Meaning Change 1 x x x x x x x Code table 8 Major x 1 x x x x x x Code table 7 Major x x 1 x x x x x Code table 6 Major x x x 1 x x x x Code table 5 Major x x x x 1 x ...

Страница 25: ...ing fails Major x x 1 x x x x x CA PK verified with check sum Major x x x 1 x x x x Bypass PIN Entry Major x x x x 1 x x x Subsequent bypass PIN Entry Major x x x x x 1 x x Get data for pin try counter Major x x x x x x 0 x RFU x x x x x x x 0 RFU Byte 4 b8 b7 b6 b5 b4 b3 b2 b1 Meaning Change 1 x x x x x x x Amount before CVM processing Major x 1 x x x x x x Floor limit checking Major x x 1 x x x ...

Страница 26: ...x x x ICC Magstripe reader combined x x 1 x x x x x Magstripe read first x x x 1 x x x x Support account type selection x x x x 1 x x x On fly script processing x x x x x 1 x x Internal date management x x x x x x 1 x Reversal Mode 1 Unable go online 2 ARC Error 0 3 Online Approved but reader not approved 1 3 Online Approved but card response AAC x x x x x x x 0 RFU Byte 8 b8 b7 b6 b5 b4 b3 b2 b1 ...

Страница 27: ...ID TECH VP3350 User Manual Page 27 Where TagCounterL TagCounterH is the Number of TLV ...

Страница 28: ...D Tag Value name Length Byte Data 1 9F01 Acquirer identifier 6 56 49 53 41 30 30 2 5F57 Account type 1 00 3 5F2A Transaction Currency 2 08 40 4 9F09 Terminal application version number 2 00 96 5 5F36 Transaction currency exponent 1 02 6 9F1B Terminal floor limit 4 00 00 3A 98 7 DF25 Default DDOL Var 9F 37 04 8 DF28 Default TDOL Var 9F 08 02 9 DFEE15 ASI 1 01 10 DF13 TAC Default 5 00 00 00 00 00 11...

Страница 29: ...inal settings a Run Set Kernel Configuration public RETURN_CODE emv_setTerminalMajorConfiguration int configuration b Run Set Terminal Configuration public RETURN_CODE emv_setTerminalData byte tlv string ident 2 Run Set Application Data public RETURN_CODE emv_setApplicationData byte name byte tlv string ident 3 Run Activate Transaction public RETURN_CODE device_startTransaction double amount doubl...

Страница 30: ... version number is correct Check the device appearance to make sure there are no holes on the device or any suspicious objects around the ICC card slot 10 Decommissioning PCI Certified Devices All PCI certified devices require proper decommissioning prior to device disposal in order to ensure the protection of all sensitive financial card data For instructions on decommissioning your device see De...

Страница 31: ...ith another unit known to work to verify that the installed USB cable wiring works correctly Some cards or fobs read but not all Possible bad card or fob Unsupported card used Wrong firmware Check to see if the card or fob is damaged Verify that the correct firmware is loaded on reader contact your ID TECH representative LEDs do not light and the beeper is not audible when presenting a card or fob...

Страница 32: ...o reload manufacture s firmware If you are unable to resolve the problem please contact support idtechproducts com sending an e mail to this address will automatically open a support ticket 11 1 Tamper Detection Codes If a tamper event occurs the VP3350 stores a tamper code in its security log Check the security log with the Get DRS Info C7 3A command see the NEO 2 Interface Developer s Guide for ...

Страница 33: ...P3350 and other ID TECH products visit the ID TECH Knowledge Base To learn more about EMV app development with the Universal SDK see EMV Transactions with Universal SDK Visit us online at http idtechproducts com Find more Tech Support resources at the ID TECH Tech Support home page ...

Отзывы: