Getting Started

Overview

In the BluePOS Go Getting Started, we introduced the ID TECH VP3350 in standalone mode: a ready-to-use Go app with its own UI and capabilities for the merchant.

The VP3350 sits on top of the merchant's device and connects over Bluetooth to iOS and Android device (e.g. phones and tablets). It also supports semi-integrated mode, which gives the merchant more control and room to customize the experience.

In the semi-integrated mode, the VP3350 employs the BluePosGoSDK. BluePosGoSDK lets an iOS/Android app launch BluePOS Go, send a payment request, and receive the result when BluePOS Go returns to the app. It supports initialization, payments, transaction history, refunds, capture, clear-data reads, and rebooting the paired reader.

VP3350 supports the following card reading methods:

Contact
Contactless
NFC
Swipe

The SDK's primary purpose is to connect a third-party app to BluePOS Go. You can build your own payment UI and flow while Bluefin handles the rest of the integration.

Bluefin provides two implemention versions of BluePosGoSDKs depending on the platform you are integrating with:

iOS SDK (Written in Swift, Deep Linking)
Android SDK (Written in Kotlin, AIDL interface)

It is important to note that while BluePosGo App is written and implemented in Flutter, its SDKs are not. These SDKs serve as a communication bridge to the BluePosGo App once it returns the result.

For example, the iOS SDK uses the callback (deep linking) URL scheme whereas the Android SDK binds to the (BluePOS Go) AIDL service to communicate with the app.

Semi-Integrated Mode

The ID TECH VP3350 in semi-integrated mode is designed primarily for small businesses and mobile merchants who need a simple, affordable way to accept card-present payments on the go or at a counter. It is well-suited for use with both iOS and Android devices, connecting over Bluetooth.

In semi-integrated mode the merchant’s own application controls the overall experience and business flow, while BluePOS Go (and the BluePosGoSDK) handles the secure payment interaction with the VP3350. Your app initiates a payment request, the customer completes the transaction on the reader, and the result is returned to your application. This gives small businesses the flexibility to keep their existing UI and processes while still benefiting from Bluefin’s certified payment handling and security.

Supported card reading methods

Contact
Contactless
NFC
Swipe

Typical use cases

Field service, delivery, and mobile sales teams accepting payments on an iPhone, iPad, or Android device
Small retail or hospitality locations that want a compact reader paired with a tablet
Pop-up shops, markets, or countertop setups where a full standalone terminal is unnecessary
Merchants who prefer to keep their own application experience but still need reliable EMV and contactless acceptance

The VP3350's compact size, rechargeable battery, and straightforward pairing make it practical for these environments without the cost or complexity of a larger countertop terminal.

Requirements and Notes

Unlike standalone mode, which requires a login, semi-integrated mode uses API credentials provided by the integrating application. Users do not need to log in separately to BluePOS Go, including during initial setup and reader pairing
Integration with Bluefin: A PayConex account and at least one API key are required. For key setup, see API Key Management.
The SDK does not process payments directly
The SDK acts as a communication layer between your application and BluePOS Go
BluePOS Go must be installed on the device. The SDK automatically launches BluePOS Go when executing commands, including initialization and payment processing. The application must remain visible during these operations and cannot run entirely in the background
All configuration must be done in BluePOS itself
- Make sure to go through the entire integration checklist before deploying your SDK-driven device into production.

📘 Supported Hardware and BluePOS Go Support

Make sure you are up-to-speed with the device's capabilities and features from our BluePOS Go User Guide:

Both SDKs call Bluefin PayConex services directly through the gateway API. For the comprehensive documentation on our gateway API, see Bluefin's PayConex™ V4 API Documentation.

P2PE Encryption

The VP3350 device employs the P2PE encryption method for all card present transactions.

For more information and visual presentations of how P2PE works, check out: