ViVOpay VP3350 Integration Manual 80178501-001 Rev. B 17 March 2021 Copyright © 2021 ID TECH. All rights reserved. ID TECH 10721 Walker Street ID TECH 10721 Walker Street, Cypress, CA 90630-4720 Tel: (714) 761-6368 Fax (714) 761-8880 www.idtechproducts.
ID TECH VP3350 User Manual Cypress, CA 90630 USA This document, as well as the software and hardware described in it, is furnished under license and may be used or copied online in accordance with the terms of such license. The content of this document is furnished for information use only, is subject to change without notice, and should not be construed as a commitment by ID TECH.
ID TECH VP3350 User Manual Cautions and Warnings Caution: Danger of Explosion if battery is incorrectly charged. Use only standard USB 5V power source. Device contains a lithium battery. Approved temperature range for storage: -20℃ to +60℃. Disposal: Contact your local recycling center. Warning: Avoid close proximity to radio transmitters, which may reduce the capabilities of the reader.
ID TECH VP3350 User Manual Table of Contents 1. INTRODUCTION................................................................................................................................................... 5 2. MAJOR VP3350 FEATURES .................................................................................................................................. 5 2.1. Contactless NFC Features and Brand Certifications ................................................................................. 5 2.2.
ID TECH VP3350 User Manual 1. Introduction The ViVOpay VP3350 is ID TECH's latest PCI 6.X SRED certified mobile reader. The VP3350 supports Magstripe, EMV contact and contactless using either USB-C, Lighting, and/or Bluetooth connections. The VP3350's compact form factor and Bluetooth interface make it ideal for mobile applications where smart card reading is required as well as incorporated into a case or stand associated with a countertop POS terminal.
ID TECH VP3350 User Manual • • JCB Contactless UnionPay International 2.2. Other Agency Approvals and Compliances • • • • • • • • • CE (EN55022/EN55024, Class- B) FCC (Part 15, Class-B) RoHS (DIRECTIVE 2011/65/EU) UL REACH EMV Contact L1&L2 EMV Contactless L1 TQM PCI PTS 6.X SRED 2.3. Operation and Storage: Environmental Limits Item Operating Temperature Specification 0 °C to 55 °C or 32°F to 131°F Note Non-condensing.
ID TECH VP3350 User Manual 3. VP3350 Connectors and Interfaces The VP3350 is designed to work Windows, Android, and iOS via a physical USB C, Lightning, USB-A to micro-USB connectors, and Bluetooth communication. • USB C communicates with popular Android mobile phones and tablets. • Lightning connectors communicate with popular mobile iOS devices. • Bluetooth connection supports both Android and iOS.
ID TECH VP3350 User Manual 4. Bluetooth Pairing Instructions In addition to the following instructions, see the section on iOS Connectivity for more information on using an iPad or iPhone in conjunction with the VP3350. 1. Enable the Bluetooth device search function on the host device (smart phone or tablet). 2. Make sure the VP3350 is charged or connected to a power source via USB. o When connected to a power source, the VP3350 automatically activates Bluetooth. 3.
ID TECH VP3350 User Manual 4.1. Battery Charging Instructions The VP3350 is powered by a lithium-ion polymer battery and is delivered in a partially charged state. Be sure to fully charge the VP3350 before using it for the first time. Allow four to six hours for the initial charge. Use a standard USB to USB-C cable to charge the unit. An LED battery indicator displays the current battery charging status. Warning: Do not use “fast chargers” with VP3350 readers. Only use a standard USB to USB-C cable. 4.2.
ID TECH VP3350 User Manual 4.3. Tamper and Failed Self-Check Indicators The VP3350 displays the following indicators when it has been tampered or has any of the other following internal issues, such as an expired certificate, missing key, or similar fault discovered during a self-check. Indicator Front Four LEDs Buzzer Tampered Status All LEDs blink red Alarm tone Other Issue Status All LEDs blink red Alarm tone 4.4. iOS Connectivity: BLE and VP3350 The VP3350 uses Bluetooth 5.
ID TECH VP3350 User Manual enable rapid application development using VP3350 as the target device. The languages supported include Objective C (on iOS), Java (on Android), and C# (on Windows). The Universal SDK includes rich, powerful libraries that make sending commands to the VP3350 comparatively easy while greatly facilitating debugging and event handling.
ID TECH VP3350 User Manual 6. Universal SDK Demo App The Universal SDK comes with a rich, fully featured demo app that allows users to run the VP3350 in USB mode. Visit the VP3350 product page to download the Universal SDK Demo app as a standalone executable, separate from the SDK; the full SDK is not required to use the demo. Be sure to check out the Universal Demo QuickStart Guide for more detailed instructions about using the Universal SDK Demo app. 6.1.
ID TECH VP3350 User Manual 7. VP3350 Low-Level Commands The following are commonly-used commands for the VP3350. For a full list of available commands, contact your ID TECH representative for the NEO 2 Interface Developer’s Guide. 7.1. Activate Transaction Command (02-40) The Activate Transaction command begins a contactless EMV or contactless MagStripe Card transaction. Note: While an Activate command is in progress, readers only accepts a Cancel or Stop command.
ID TECH VP3350 User Manual Activate Transaction Command Frame Data Format Data Item Timeout Length (bytes) 1 Description Time in seconds that the reader waits for a card to be presented before timing out and returning an Error response. The reader will continue to poll for this amount of time if no card is found. Note that if a card is found, the transaction may not complete within the timeout period. This field must be present in the Activate command.
ID TECH VP3350 User Manual Response Frame Byte 0-9 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14 Byte 15 Header Tag & Protocol Version Cmd status Length (MSB) Length (LSB) CRC (LSB) CRC (MSB) ViVOtech2\0 D0h See Key Manager status codes 00h 00h Calculated Calculated 7.3. Get Processor Type (09-02) The Get Processor Type command returns a processor type TLV. Command Frame Byte 0-9 Byte 10 Header Tag & Protocol Command ViVOtech2\0 09h Byte 11 SubCommand Byte 12 Data Length (MSB) Byte 1
ID TECH VP3350 User Manual The following example shows the command and response. Command: Get Processor Type: 56 69 56 4F 74 65 63 68 32 00 09 02 00 00 F0 F9 Response: 56 69 56 4F 74 65 63 68 32 00 09 00 00 05 DF 61 02 4D 00 AC 4D 7.4. Get Main Firmware Version (09-03) The Get Main Firmware Version command returns main firmware version TLV.
ID TECH VP3350 User Manual Byte 0-9 Byte 10 Byte 11 Protocol ViVOtech2\0 09h Byte12 Byte 13 Length (MSB) Length (LSB) See Status Code Table Byte 14 … Byte 13+n Byte 14+n Byte 15+n (MSB) (LSB) See below The format for hardware module version information returned is “human readable,” consisting of fields that are separated by commas, and lines separated by carriage return and line feed characters: , The following example shows the hardware versio
ID TECH VP3350 User Manual 7.6. Get Module Version Information (09-20) The Get Module Version Information command retrieves the reader’s module information. Command Frame Byte 0-9 Header Tag & Protocol Byte 10 Command ViVOtech2\0 Byte 11 SubCommand Byte 12 Data Length (MSB) Byte 13 Data Length (LSB) 20h 00h 00h 09h Byte 14 CRC (LSB) Byte 15 CRC (MSB) Response Frame Byte 0-9 Byte 10 Byte 11 Byte12 Byte 13 Byte 14 … Byte 13+n Byte 14+n Byte 15+n Header Tag & Protocol Command Status Code
ID TECH VP3350 User Manual CL AID,MasterCard PayPass M/Chip v3.0.2, Vendi v1.0.0,, CL AID,Visa VCPS 2.1.3, v0.99,, CL AID,Amex ExpressPay 3.0, v1.00,, CL AID,Discover DPAS 1.0 Zip 3.1.2, v1.00,, CL AID,Interac 1.5, v1.00,, CL L1,EMV 4.3 L1, v1.00 7.7. Get Serial Number (12-01) The Get Serial Number command instructs the ViVOpay reader to return the 15-digit serial number stored in its non-volatile memory.
ID TECH VP3350 User Manual 7.8. Contact Set ICS Identification (60-16) The Contact Set ICS Identification command sets the reader’s ICS terminal configuration number (Contact Command EMV L2 includes 4 approved configurations of certification: 1C, 2C, 3C, or 4C). This command affects the Contact Set Terminal Data (60-06) command. Generally, readers call 6016 first, then 60-06.
ID TECH VP3350 User Manual 7.9. Contact Set Terminal Data (60-06) The Contact Set Terminal Data command creates new terminal data according to the TLVs passed in. Terminal data is mandatory and seldom changes. It represents configuration data that usually gets set one time in pre-production and never changes after.
ID TECH VP3350 User Manual Terminal Data List Example Data ID 1 2 3 4 5 6 Tag Value name Length (Byte) 1 2 1 3 5 8 5F36 9F1A 9F35 9F33 9F40 9F1E Transaction currency exponent Terminal county code Terminal type Terminal capability Additional terminal capability IFD serial number 7 8 9F15 9F16 Merchant category code Merchant identifier 2 15 9 9F1C Terminal identification 8 10 9F4E Merchant name and location 11 12 DF26 DF10 Terminal supports CRL Language 13 14 15 16 17 18 19 DF11 DF27 DFE
ID TECH VP3350 User Manual Tag 9F33 9F35 Description Terminal Capabilities Byte 1 b8 b7 b6 b5 1 x x x x 1 x x x x 1 x x x x 0 x x x x x x x x x x x x x x x x Length 3 b4 x x x x 0 x x x b3 x x x x x 0 x x b2 x x x x x x 0 x b1 x x x x x x x 0 Meaning Manual key entry Magnetic stripe IC with contacts RFU RFU RFU RFU RFU Byte 2 b8 b7 1 x Meaning Plaintext PIN for IC verification Enciphered PIN for online verification Signature(paper) Enciphered PIN for offline verification No CVM Required RFU RFU RF
ID TECH VP3350 User Manual Byte 2 b8 1 x x x x x x x b7 x 0 x x x x x x b6 x x 0 x x x x x b5 x x x 0 x x x x b4 x x x x 0 x x x b3 x x x x x 0 x x b2 x x x x x x 0 x b1 x x x x x x x 0 Meaning Cash Deposit RFU RFU RFU RFU RFU RFU RFU Change Byte 3 b8 b7 1 x x 1 b6 x x b5 x x b4 x x b3 x x b2 x x b1 x x Change x x x x x x 1 x x x x x x 1 x x x x x x 0 x x x x x x 0 x x x x x x 0 x x x x x x 0 Meaning Numeric keys Alphabetic and special characters keys Command keys Function Keys RFU
ID TECH VP3350 User Manual Byte 1 b8 1 x x x x x x x b7 x 1 x x x x x x b6 x x 1 x x x x x b5 x x x 1 x x x x b4 x x x x 0 x x x b3 x x x x x 0 x x b2 x x x x x x 0 X b1 x x x x x x x 0 Meaning Key Pad support LCD support PIN Pad support Print Support RFU RFU RFU RFU Change Byte 2 b8 1 x x x x x x x b7 x 1 x x x x x x b6 x x 1 x x x x x b5 x x x 1 x x x x b4 x x x x 1 x x x b3 x x x x x 1 x x b2 x x x x x x 0 x b1 x x x x x x x 0 Meaning PSE support Cardholder confirmation Preferred displ
ID TECH VP3350 User Manual x x x x x 1 x x x x x x x x 1 x x x x x x x x b7 x 1 x x x x x x b6 x x 1 x x x x x b5 x x x 1 x x x x b4 x x x x 1 x x x b3 x x x x x 1 x x Byte 7 b8 b7 1 x b6 x b5 x b4 x Byte 6 b8 1 x x x X x X X Major 0 TAC/IAC default process when unable to go online (Skipped) TAC/IAC default process when unable to go online (Normal) RFU b2 x x x x x x 1 x b1 x x x x x x x 0 Meaning Forced Online support Forced acceptance support Advices support Issuer r
ID TECH VP3350 User Manual Where: is the Number of .
ID TECH VP3350 User Manual 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) Data Length (LSB) Data CRC (MSB) CRC (LSB) ViVOtech2\0 60h See Status Code Table See Response Frame Data Format Note: • If there was a format error, the response status code is 0x05. • If AID List is full (MAX is 16), the response status code is 0x61.
ID TECH VP3350 User Manual 8. Basic Card Reading Data Flow The following examples describe the basic steps for setting a reader’s terminal settings and activating a transaction. 8.1. Example: Reading a Card via Firmware Commands Perform the following steps and commands to read a card with the VP3350 via NEO 2 protocol firmware commands. 1. Set the device’s terminal settings: a.
ID TECH VP3350 User Manual • • • • Check the device overlay to make sure it is intact. Power on the device to check the beeper and the display message: o Make sure there is no beeping that indicates the tamper was triggered. o Read the firmware version to make sure the 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.
ID TECH VP3350 User Manual 11. Troubleshooting The VP3350 is designed to be reliable and easy to troubleshoot. The components that may require troubleshooting include the power module (if applicable), the reader, and the serial cable.
ID TECH VP3350 User Manual Symptom Fail to start transaction, 0x04 returned Firmware loading software indicates “Open device failed” Firmware loading software indicates “Load firmware failed" Firmware loading software indicates “Send Command failed” Probable Cause Missing Key Remedy Please re-start VP3350 and monitor the LEDs to confirm whether to Load LCL key or Data Key Device is not fully connected to PC • Check the cable connection Device is not fully connected to PC Check the cable connections
ID TECH VP3350 User Manual 12. For More Information • • • • To learn more about VP3350 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.
