Advertisement

Quick Links

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

Advertisement

Table of Contents
loading

Summary of Contents for IDTECH ViVOpay VP3350

  • Page 1 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.com...
  • Page 2 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.
  • Page 3 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.
  • Page 4: Table Of Contents

    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. Other Agency Approvals and Compliances ....................6 2.3. Operation and Storage: Environmental Limits ..................6 2.4.
  • Page 5: Introduction

    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.
  • Page 6: Other Agency Approvals And Compliances

    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) • • REACH • EMV Contact L1&L2 • EMV Contactless L1 •...
  • Page 7: Vp3350 Connectors And Interfaces

    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. •...
  • Page 8: Bluetooth Pairing Instructions

    3. When not connected to a power source, press the VP3350’s power button to automatically activate Bluetooth. 4. Find a Bluetooth device 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.
  • Page 9: Battery Charging Instructions

    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.
  • Page 10: Tamper And Failed Self-Check Indicators

    The VP3350 has a default friendly name of IDTECH-VP3350-XXXXX. This is the default name the ID TECH Universal SDK uses to connect to the first VP3350 it encounters if no other friendly name is set in the SDK, or when the iOS-generated device identifier is not provided.
  • Page 11: Updating Vp3350 Firmware

    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.
  • Page 12: Universal Sdk Demo App

    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;...
  • Page 13: Vp3350 Low-Level Commands

    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.
  • Page 14: Set Ca Public Key (D0-03)

    ID TECH VP3350 User Manual Activate Transaction Command Frame Data Format Data Item Length (bytes) Description Timeout 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.
  • Page 15: Get Processor Type (09-02)

    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 Length Length status Version (MSB) (LSB) (LSB) (MSB) See Key ViVOtech2\0 Manager Calculated Calculated status codes 7.3.
  • Page 16: Get Main Firmware Version (09-03)

    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 Response: 56 69 56 4F 74 65 63 68 32 00 09 00 00 05 DF 61 02 4D 00 AC 7.4.
  • Page 17 ID TECH VP3350 User Manual Byte 14 … Byte 0-9 Byte 10 Byte 11 Byte12 Byte 13 Byte 14+n Byte 15+n Byte 13+n Protocol Length Length (MSB) (LSB) (MSB) (LSB) See Status ViVOtech2\0 See below Code Table 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: <module type>,<module name><CRLF>...
  • Page 18: Get Module Version Information (09-20)

    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 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14 Byte 15 Header Tag & Sub- Data Length Data Length...
  • Page 19: Get Serial Number (12-01)

    ID TECH VP3350 User Manual CL AID,MasterCard PayPass M/Chip v3.0.2, Vendi v1.0.0,,<CR><LF> CL AID,Visa VCPS 2.1.3, v0.99,,<CR><LF> CL AID,Amex ExpressPay 3.0, v1.00,,<CR><LF> CL AID,Discover DPAS 1.0 Zip 3.1.2, v1.00,,<CR><LF> CL AID,Interac 1.5, v1.00,,<CR><LF> CL L1,EMV 4.3 L1, v1.00<NUL> 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.
  • Page 20: Contact Set Ics Identification (60-16)

    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 60- 16 first, then 60-06.
  • Page 21: Contact Set Terminal Data (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.
  • Page 22 ID TECH VP3350 User Manual Terminal Data List Example Data Value name Length Data (Byte) 5F36 Transaction currency exponent 9F1A Terminal county code 08 40 9F35 Terminal type 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...
  • Page 23 ID TECH VP3350 User Manual Description Length 9F33 Terminal Capabilities Byte 1 Meaning Change Manual key entry Magnetic stripe IC with contacts Major Byte 2 Meaning Change Plaintext PIN for IC Major verification Enciphered PIN for Major online verification Signature(paper) Major Enciphered PIN for Major...
  • Page 24 ID TECH VP3350 User Manual Byte 2 Meaning Change Cash Deposit Byte 3 Meaning Change Numeric keys Alphabetic and special characters keys Command keys Function Keys Byte 4 Meaning Change Print, attendant Print, cardholder Display, attendant Display, cardholder Code table 10 Major Code table 9 Major...
  • Page 25 ID TECH VP3350 User Manual Byte 1 Meaning Change Key Pad support LCD support PIN Pad support Print Support Byte 2 Meaning Change PSE support Major Cardholder confirmation Major Preferred display order Multi language EMV language selection method Default DDOL Major Byte 3 Meaning...
  • Page 26: Contact Set Application Data (60-03)

    ID TECH VP3350 User Manual TAC/IAC default process when Major unable to go online (Skipped) TAC/IAC default process when Major unable to go online (Normal) Byte 6 Meaning Change Forced Online support Major Forced acceptance support Major Advices support Major Issuer referrals support Major Batch data capture...
  • Page 27 ID TECH VP3350 User Manual Where: <TagCounterL><TagCounterH>is the Number of <TLV>. Page | 27...
  • Page 28 ID TECH VP3350 User Manual Response Frame Byte 14 … Byte 0-9 Byte 10 Byte 11 Byte 12 Byte 13 Byte 14+n Byte 15+n Byte 14+n-1 Header Tag & Data Data Protocol Command Status Code Length Length Data CRC (MSB) (LSB) Version (MSB)
  • Page 29: Basic Card Reading Data Flow

    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.
  • Page 30: Decommissioning Pci-Certified Devices

    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.
  • Page 31: Troubleshooting

    Symptom Probable Cause Remedy General Issues 4 RED LEDs blink and the Unit has been tampered Contact IDTECH Support device beeps 4 Yellow and RED LEDs blink Unit was not activated Contact IDTECH Support and the device beeps 4 Yellow LEDs are on...
  • Page 32: Tamper Detection Codes

    ID TECH VP3350 User Manual Symptom Probable Cause Remedy Fail to start transaction, Missing Key Please re-start VP3350 and monitor the LEDs to 0x04 returned confirm whether to Load LCL key or Data Key Firmware loading software Device is not fully connected •...
  • Page 33: For More Information

    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.

Table of Contents