background image

 

 

ViVOpay VP3300BT User Manual 

Page | 14  

 

6.

 

For Software Developers: Software Development Support 

By virtue of its EMV L2 kernel, the VP3300BT is compatible with a wide range of third-party 

payment applications. Leveraging the Universal SDK (available for iOS, Android, or Windows) in 

addition to ID TECH’s common contact kernel enables rapid application development using the 

VP3300BT as the target device. The Universal SDK includes versatile libraries that make sending 

commands to the VP3300BT while greatly facilitating debugging and event handling. 

 

To obtain the Universal SDK free of charge, visit th

VP3300BT product page

 and select the SDK 

version for the desired host platform (Android, iOS, Linux, MacOS, or Windows). Normally, 

applications that take advantage of the VP3300BT's capabilities can developed in a high-level 

language like C# or Java using convenience objects and data structures defined in the Universal 

SDK, obviating the need to send byte commands directly.  

 

Nevertheless, developers can communicate with the device with low-level commands. For a 
command reference for the VP3300BT, contact an ID TECH representative to request the 

NEO 

Interface Developers Guide (IDG), P/N 80139403-001

.  This document includes not only low-level 

(firmware) commands but error codes, response codes, and information on various default 

settings. 

 

6.1.

 

Best Practices for VP3300BT Developers 

When developing payment applications for Android and iOS, make sure to consult the 

ID TECH 

Universal SDK Guide

 for your respective platform for best practices to follow. Download the 

Universal SDK Guide

 

from the 

VP3300BT product page

 as part of the ZIP file for your development 

platform. 

 

ID TECH strongly recommends that integrators include a way for users to update their 

passwords. 

 

 

Summary of Contents for ViVOpay VP3300BT

Page 1: ...ID TECH 10721 Walker Street Cypress CA 90630 Voice 714 761 6368 Fax 714 761 8880 idtechproducts com ViVOpayVP3300BT UserManual 80149515 001 Rev M 25 February2021 ...

Page 2: ...fID TECH Warranty Disclaimer The servicesandhardware are provided asis and as available andthe use ofthe servicesand hardware are atits own risk ID TECH doesnot make andherebydisclaims anyandall other expressorimpliedwarranties including but not limited to warrantiesofmerchantability fitness for a particularpurpose title andany warrantiesarising from a course of dealing usage ortrade practice ID T...

Page 3: ...Part15 of the FCCrules Operationis subjectto two conditions 1 This device may not cause harmfulinterference and 2 this device mustacceptanyinterference received including interference thatmaycause undesiredoperation If this equipmentdoescause harmfulinterference toradioor televisionreception whichcanbe determinedbyturning the equipmentoffandon the useris encouragedtotryto correctthe interference b...

Page 4: ... Management Bottom LED 8 4 4 VP3300BT Power States 9 4 5 What Kind of USB Cable to Use with a VP3300BT 10 5 BLUETOOTH CONNECTIVITY AND LED INDICATORS 11 5 1 Bluetooth Pairing Connection Top LED 11 5 2 Bluetooth Range 12 5 3 VP3300BT LED State Indicators 12 5 4 LED Display for Bluetooth Status Top LED 12 5 5 LED Display During Transactions and Operation 12 5 6 iOS Connectivity BLE and VP3300BT 13 5...

Page 5: ...ing applicationsthatuse the VP3300BT Contactyour acquirer gateway orPOS partnerforinstructions on setting up andpairing the VP3300BT to a compatible paymentapplicationandassociatedhostdevice 2 Major Features Communicatesvia BluetoothBLE Bluetooth Low Energy SupportsApple iOS Android andWindows platforms Rechargeable battery noexternalpowernecessary MagStripe ISO7810 ISO 7811 Hi Co Lo CoMagnetic JI...

Page 6: ...ication Note Operating Temperature 0 C to 55 C or 32 Fto 131 F Non condensing Product operation temperature is limitedto this range due to constraints of the Li Battery specification Storage Temperature 20 C to 60 C or 4 F to 140 F Non condensing Product storage temperature is limitedto this range due to constraints of the Li Battery specification Operating Humidity Up to 95 Non condensing Storage...

Page 7: ...o the host device install andactivate the software application service according tothe instructionsprovidedby the paymentapplicationservice andsoftware provider thenconnectthe VP3300BT to the mobile device via the Bluetoothor through the includedmicro USBcable andenjoythe convenienceofmobile paymentprocessing offeredby the VP3300BT 3 1 VP3300BT PinReset Note that the VP3300BT hasa pin resetswitch ...

Page 8: ... 1 Electrical Power Run mode 54 6mA Low Powermode 2 35 5 5mA Contact 90mA Contactless 400mA Magnetic stripe transaction 90mA Off mode 2 5uA 4 2 BatteryLife 72 hour standby including 100 EMV transactions 100 MSR transactions and100 NFC transactionsfrom full batteryuntil unit shuts off 4 3 LED Displayfor Power Management Bottom LED The back middle LED displayssolid red Battery is charging The back m...

Page 9: ...sendsany firmware command o A userplugs the readerinto a USBport o A userinserts anICC card o A userswipes a card Run Mode to Low PowerMode The following situations sendthe readertoenterLow Power Mode o The host sendsa firmware commandinitialize LowPower Mode o Low batterylevel causesthe readertoenterLow PowerMode SleepMode to Low PowerMode o The VP3300BT entersLow Power Mode if it hasbeenin Sleep...

Page 10: ...connectthe VP3300BT to a computertopowerthe device anduse the computerasa host device USB HID StandardmicroUSB cable I want to connectthe VP3300BT to a mobile device to powerthe VP3300BT and connecttothe host device via Bluetooth Bluetooth StandardmicroUSB cable I want to connectthe VP3300BT to a mobile device to powerthe VP3300BT use the mobile device asa host device andpower boththe VP3300BT and...

Page 11: ...n is locatedonthe side ofthe case nearthe ICC slot 4 Find BluetoothID VP3300BT on the host smartphone or tabletand selectPairto finish the pairing process 5 Follow the instructionsfor the compatible paymentsoftware toperform a payment transaction The VP3300BT will remainconnectedtothe host indefinitely via Bluetooth if poweredvia a USB cable Ifthe unit is operating onbatterypower the defaultvalue ...

Page 12: ...onsuccessful on on on on off off Transactionfailed off off off off fast blink off 5 4 LED Displayfor BluetoothStatus Top LED The Bluetooth LED is off Bluetoothis in sleepmode The LED flashesat normaldurationspeed Bluetoothis on stand by The LED flashesat shortduration speed Bluetoothis pairedandconnected 5 5 LED DisplayDuring Transactions andOperation First front LED flashesgreen ICCprocessing The...

Page 13: ...ID TECH UniversalSDK usesto connecttothe first VP3300BT it encounterswhennoother friendly name isset in the SDK or when noiOS generateddevice identifierisprovided See links nearthe endof this documentforinformationaboutthe UniversalSDK Note that the UniversalSDK is primarily of interestto developers Ifthe applicationproviderorPOS software partnerhasalreadyprovidedsoftware to use in conjunctionwith...

Page 14: ...P3300BT s capabilitiescandevelopedina high level language like C or Java using convenience objectsanddata structuresdefinedinthe Universal SDK obviating the needto sendbyte commandsdirectly Nevertheless developerscancommunicate withthe device with low levelcommands Fora commandreference forthe VP3300BT contactanID TECH representative torequestthe NEO InterfaceDevelopersGuide IDG P N 80139403 001 T...

Page 15: ...uded 3 Openthe USDK Demoapp The USDK Demoappdisplaysthe VP3300BT s available commandsina commandtree asshown above Single clickona commandtopopulate the centerpanelofthe window with optional settingsrelevantto the command e g AmountandStart EMVAdditionalTags Insome cases text fieldsappearforusersto entercustom values To execute the commandinquestion double clickitin the commandtree oruse the Execu...

Page 16: ...versalSDK or via low levelcommands To implementthe USDK method reviewthe USDK packagewithsample source code and documentationappropriate tothe desiredplatform Toimplementthe low levelcommand method contactyourID TECH representative forinformation Note Before starting contactyourID TECH representative toreceive the mostrecentVP3300BT firmware Downloadthe ZIP file andextractit to your computer 1 Con...

Page 17: ... device 7 Whenthe firmware update completes the VP3300BT rebootsagainandthe USDK Demo appprints Firmware Update Successfulinthe Resultspanel 8 For More Information To learnmore aboutthe VP3300BT andotherID TECHproducts be sure to visit the ID TECH Knowledge Base To learnmore aboutEMV appdevelopmentwiththe UniversalSDK readEMV TransactionswithUniversalSDK pdf Visit us online athttp idtechproducts c...

Reviews: