VP3350
Everything you need to build and test in-person payments fast
Enable your merchants to accept card payments anywhere by integrating with our iOS/Android SDKs.
The SDKs include:
- A mobile card reader library for encrypted card readers
- End-to-end encryption for swiped, dipped, and tapped card payments
- Support for pre-certified EMV card readers (no extra certifications required)
1.π¦Unbox Your VP3350 Device
Each VP3350 kit contains:
- 1 VP3350 card reader (Lightning / USB-C / Bluetooth)
- 1 USB-C to USB-C cable
- 1 Optional Mounting bracket kit (USB-C & Lightning only)
- Bracket, screwdriver, screws, adhesive pads
- 1 Quick start guide (QR code)
Current NMI Partners can purchase test and live devices from within the NMI Partner Portal.
If you are not yet an NMI Partner but would like to purchase a test device, you can purchase devices directly from NewBold Technologies here.
2.β‘Charge & Power On
- Charge the VP3350 for 4β6 hours before first use.
- Power via USB or press the** power button** for battery use.
- The LED/sound indicators show device status (see diagram in portal).
3.πConnect Your Device
Bluetooth (iOS & Android)
- Turn on Bluetooth on your phone/tablet.
- Ensure the VP3350 is charged or plugged in.
- Press the power button (if battery-powered). The LED flashes green.
- Pair with IDTECH-VP3350-XXXXX.
- Enter the default password: 123456.
- On success, the device beeps and all 4 lights flash.
Note: On USB power, the VP3350 stays connected. On battery, it sleeps after 30 seconds idle.
USB / Lightning
Android
- Plug the VP3350 (USB-C) into the Android device.
- Approve the USB Manager access popup.
iOS
- Add
UISupportedExternalAccessoryProtocols
βcom.idtechproducts.neo
inInfo.plist
. - Plug in the Lightning/USB-C VP3350.
- Discover it using
getAvailablePinPad()
.
β οΈ When switching from Lightning to Bluetooth VP3350, unplug Lightning before connecting Bluetooth.
4.πEnable Encrypted Devices
To process in-person payments, enable Encrypted Devices in the NMI Marketplace:
- Partner Portal β Marketplace β Enable Encrypted Devices.
- Merchant Portal β Marketplace Apps β Confirm visibility.
5.π§ͺUse Test Mode
- Test Mode lets you run real hardware tests with no live charges.
- Enable in Merchant Portal β Settings β Test Mode β Enable Test Mode.
- Disable before going live.
β οΈ Transactions in Test Mode are not processed for payment.
6.π οΈInstall the SDK
Download the Payment Device SDK (zip archive) for iOS/Android. Each contains:
- Example apps (Java, Kotlin, Objective-C, Swift)
- SDK binaries (libs or .xcframework)
- Documentation (/doc)
Add required dependencies:
- iOS: iOS 15+, SQLCipher, ID TECH SDK, accessory protocols in
Info.plist
- Android: Android 12+, Gradle dependencies (
SQLCipher
,sqlite
,timber
), Bluetooth & USB permissions
7.βοΈConfigure Your Account
- Create an API Key in Merchant Portal β Settings β Security Keys.
- Must be API-source only.
- Set Application Identifier (unique alphanumeric word, e.g. your app name).
These values must remain consistent across platforms.
8.πInitialize the SDK
Key SDK methods:
initialize()
β Start SDK instancesetProperties()
β Set API key, App ID, and PIN pad nameconnectAndConfigure()
β Connect device + auto-update firmware/configgetAvailablePinPads()
β Discover paired readersgetStatus()
β Device/SDK status
9.π³Run Transactions
Typical flow:
- Call
startTransaction()
with amount, type, and currency. - Listen for callbacks:
userNotification
β Display promptsapplicationSelection
β Card type selectionsignatureVerification
β Signature requiredtransactionFinished
β Result returned
- Call
confirmTransaction()
to settle approved transactions.- Or
voidTransaction()
to cancel before settlement.
- Or
10.β¨Advanced Features
- Deferred Authorizations β Allow offline approvals (risk to merchant).
- RequestQueueStatus β Manage pending/failed offline transactions.
- Firmware/TMS Updates β SDK manages automatically or via
requestTmsUpdate()
. - Receipts β Email/SMS certified receipts using
processReceipt()
.
11.πCompliance & App Store Submission
- Only declare supported device protocols in
Info.plist
. - For App Store: include test credentials + user guide/video in review notes.
- For Google Play: confirm export compliance forms (due to SQLCipher encryption).
12.πProduction Checklist (recap)
- Disable Test Mode in Merchant Portal before launch.
- Confirm TMS settings for your Application Identifier (receipt routing, signature capture, gratuity, refunds).
- Ensure only the accessory protocols you support are listed in the iOS
Info.plist
. - Make sure Android permissions and USB features are declared, and ProGuard excludes SDK libs.
- Open firewall for CardEaseXML and CardEaseTMS hosts (443).
- Implement reconciliation if using Deferred Authorization/offline queues.
β
Youβre now ready to integrate the NMI Mobile SDK and VP3350 device into your app.
Navigate through the pages in the developer portal for more details, including visual aids, flow diagrams, and code samples.
Updated 9 days ago