Advertisement

Quick Links

ViVOpay VP3320S
Integration Manual
80173501-001 Rev. E
21 September 2020
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 VP3320S

  • Page 1 ViVOpay VP3320S Integration Manual 80173501-001 Rev. E 21 September 2020 ID TECH 10721 Walker Street, Cypress, CA 90630-4720 Tel: (714) 761-6368 Fax (714) 761-8880 www.idtechproducts.com...
  • Page 2 ID TECH ViVOpay VP3320 User Manual Copyright © 2020 ID TECH. All rights reserved. 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 ViVOpay VP3320 User Manual FCC warning statement This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
  • Page 4 ID TECH ViVOpay VP3320 User Manual Internal Rechargeable Battery Warning Danger: 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.
  • Page 5: Table Of Contents

    ID TECH ViVOpay VP3320 User Manual Table of Contents 1. INTRODUCTION ..................................6 2. MAJOR VP3320S FEATURES ..............................6 2.1. Contactless NFC Features............................7 2.2. Other Agency Approvals and Compliances ......................7 2.3. Operation and Storage: Environmental Limits ..................... 8 2.4.
  • Page 6: Introduction

    ID TECH ViVOpay VP3320 User Manual 1. Introduction The ViVOpay VP3320S is ID TECH's latest PCI 5.X SRED certified mobile reader. The VP3320S supports EMV contact and contactless, Bluetooth, and micro-USB connections. The VP3320S's small 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 7: Contactless Nfc Features

    ID TECH ViVOpay VP3320 User Manual 2.1. Contactless NFC Features • ISO 14443 Type A&B • ISO 18092 (P2P) • MasterCard® MChip 3.1 (Formerly PayPass) • Visa payWave/VCPS 2.2 • Visa IRWIN • Discover® DPAS • American Express® ExpressPay • Interac Flash •...
  • Page 8: Operation And Storage: Environmental Limits

    ID TECH ViVOpay VP3320 User Manual 2.3. Operation and Storage: Environmental Limits Item Specification Note Operating Temperature 0 °C to 55 °C Non-condensing. Product operation temperature is limited to this range due 32°F to 131°F to constraints of the Li-Battery specification. Storage Temperature -20 °C to 60 °C Non-condensing.
  • Page 9: Battery Charging Instructions

    ID TECH ViVOpay VP3320 User Manual 3.1. Battery Charging Instructions The VP3320S is powered by a lithium-ion polymer battery and is delivered in a partially charged state. Be sure to fully charge the VP3320S before using it for the first time. Allow four to six hours for the initial charge.
  • Page 10: Ios Connectivity: Ble And Vp3320S

    ID TECH ViVOpay VP3320 User Manual 3.3. iOS Connectivity: BLE and VP3320S The VP3320S uses Bluetooth 4.2, also known as Bluetooth BLE (Bluetooth Low Energy). Unlike previous versions of Bluetooth, BLE does not require users to first pair their devices through the Bluetooth Settings in Apple iOS.
  • Page 11: Id Tech Universal Sdk

    ID TECH ViVOpay VP3320 User Manual 5. ID TECH Universal SDK By virtue of its EMV L2 kernel, VP3320S is designed to be compatible with a wide range of third- party payment applications. ID TECH offers a Universal SDK (available for iOS, Android, or Windows) to enable rapid application development using VP3320S as the target device.
  • Page 12: Universal Sdk Demo App

    ID TECH ViVOpay VP3320 User Manual 6. Universal SDK Demo App The Universal SDK comes with a rich, fully featured demo app that allows users to run the VP3320S in USB mode. Visit the VP3320S product page to download the Universal SDK Demo app as a standalone executable, separate from the SDK;...
  • Page 13: Vp3320S Low-Level Commands

    ID TECH ViVOpay VP3320 User Manual 7. VP3320S Low-Level Commands The following are commonly-used commands for the VP3320S. 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 ViVOpay VP3320 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 ViVOpay VP3320 User Manual in a 4-byte field) 23-26 Public Key Actually, the real length of the exponent is either one byte or 3 bytes. Exponent It can have two values: 3, or 65537. 27-28 Modulus Length Indicates the length of the next field, MSB followed by LSB. 29-n Modulus Variable...
  • Page 16: Get Main Firmware Version (09-03)

    ID TECH ViVOpay VP3320 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 ViVOpay VP3320 User Manual Response Frame Byte 14 … Byte Byte 0-9 Byte 10 Byte 11 Byte12 Byte 13 Byte 15+n Byte 13+n 14+n Data Data Header Tag & Command Status Code Length Length Data Protocol (MSB) (LSB) (MSB) (LSB) See Status...
  • Page 18: Get Module Version Information (09-20)

    ID TECH ViVOpay VP3320 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 ViVOpay VP3320 User Manual ASCII translation of the data field: FW,Vendi V1.00,,<CR><LF> FS&DB V1.00,,<CR><LF> CL AppSel,PPSE Module, v1.00,,<CR><LF> 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>...
  • Page 20: Contact Set Ics Identification (60-16)

    ID TECH ViVOpay VP3320 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.
  • Page 21: Contact Set Terminal Data (60-06)

    ID TECH ViVOpay VP3320 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 ViVOpay VP3320 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 ViVOpay VP3320 User Manual Terminal configuration Identification Major 9F33 60 F8 C8 60 28 C8 60 D8 C8 60 08 C8 parameters 9F35 9F40 F0 00 F0 A0 01 F0 00 F0 A0 01 60 00 F0 50 01 60 00 F0 50 01 DF11 DF26...
  • Page 24 ID TECH ViVOpay VP3320 User Manual Offline with online capability Offline only Unattended Major Online only Offline with online capability Offline only 9F40 Additional Terminal Capabilities Byte 1 Meaning Change Cash Major Goods Major Services Major Cashback Major Inquiry Transfer Payment Administrative Byte 2...
  • Page 25 ID TECH ViVOpay VP3320 User Manual Code table 10 Major Code table 9 Major Byte 5 Meaning Change Code table 8 Major Code table 7 Major Code table 6 Major Code table 5 Major Code table 4 Major Code table 3 Major Code table 2 Major...
  • Page 26 ID TECH ViVOpay VP3320 User Manual Manual action when CA PK Major loading fails CA PK verified with check sum Major Bypass PIN Entry Major Subsequent bypass PIN Entry Major Get data for pin try counter Major Byte 4 Meaning Change Amount before CVM processing Major...
  • Page 27: Contact Set Application Data (60-03)

    ID TECH ViVOpay VP3320 User Manual combined Magstripe read first Support account type selection On fly script processing Internal date management 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.
  • Page 28 ID TECH ViVOpay VP3320 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 ViVOpay VP3320 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 VP3320S via NEO 2 protocol firmware commands.
  • Page 30: Periodic Inspection Instructions

    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 Unit was not activated Contact IDTECH Support blink and the device beeps 4 Yellow LEDs are on...
  • Page 31: For More Information

    ID TECH ViVOpay VP3320 User Manual Symptom Probable Cause Remedy LEDs do not light and the • Card, fob, or phone not • Present card, fob, or phone closer to the antenna beeper is not audible when properly presented and ensure it is parallel to the face of the reader presenting a card or fob •...

Table of Contents