IDTECH ViVOpay VP3350, Integration Manual

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Page 27: ...ID TECH VP3350 User Manual Page 27 Where TagCounterL TagCounterH is the Number of TLV ...

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

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

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

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

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

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