DocumentationLegacy Documentation
Guides
Partner PortalMerchant Portal

Connection Requirements

Suggest Edits

USB / Lightning

The Payment Device SDK for Android has the ability to connect to devices over USB to compatible Android devices.

ID TECH VP3350 Android

  1. Plug the ID TECH USB-C PIN pad into the Android device.
  2. A pop-up will display asking for permission to be given to the USB Manager to access the device.
  3. Grant access to the USB Manager.

ID TECH VP3350 IOS (Lightning and USB-C)

  1. Ensure you have correctly added the required UISupportedExternalAccessoryProtocols string to the projects info.plist.
  2. Plug in the ID TECH Lightning or USB-C PIN pad into the iOS device.
  3. Search for the PIN pad using the getAvailablePinPad() method.
When switching between a lightning ID TECH VP3350 and a Bluetooth ID TECH VP3350 you will need to unplug the lighting device before a connection can be made to the Bluetooth device.

USB devices now behave identically to Bluetooth devices. All that is required is setting the PIN pad name from getAvailablePinPads() along with a connection type.

Bluetooth

Miura

  1. Turn the PIN pad on and wait until MIURA SYSTEMS is displayed along with a Bluetooth and battery indicator. Press and hold the green tick button until the Bluetooth indicator is flashing to show it is now discoverable. (If the PIN pad has never been paired the Bluetooth indicator will already be flashing).
  2. On the mobile device select the PIN pad from the list of detected Bluetooth devices. The mobile device should display a prompt containing a passkey and the same passkey should be displayed on the PIN pad.
  3. If the two passkeys are the same, press ‘Pair’ on the mobile device and the green tick button on the PIN pad. Once pairing is complete this should be reported on the mobile device and the PIN pad should return to its standby screen.

BBPOS Chipper 2X BT

  1. Turn the payment device on by pressing the power button on the side. Wait until the LED indicator continuously flashes blue.
  2. The BBPOS Chipper PIN pads are supported with Bluetooth Low Energy (BLE) connection instead of Bluetooth Classic connection. The mobile device and the BBPOS Chipper do not need to be paired before connecting.
  3. The device will now appear in the list of available payment devices within the SDK.
Pairing with the BBPOS Chipper 2X BT on iOS will prevent the mobile and PIN pad from being able to communicate.

BBPOS Chipper 3X BT

  1. Turn the payment device on by pressing the power button on the side. Wait until the LED indicator continuously flashes blue.
  2. The BBPOS Chipper PIN pads are supported with Bluetooth Low Energy (BLE) connection instead of Bluetooth Classic connection. The mobile device and the BBPOS Chipper do not need to be paired before connecting.
  3. The device will now appear in the list of available payment devices within the SDK.
  4. The mobile device will require a pin to be entered upon connection to the PIN pad, this number can be found on the back of the Chipper.
Pairing with the BBPOS Chipper 3X BT on iOS will prevent the mobile and PIN pad from being able to communicate.

ID TECH VP3350 Android

  1. Turn the payment device on by pressing the power button on the side.
  2. On the mobile device, within the mobile device’s settings menu, select the PIN pad from the list of detected Bluetooth devices. The mobile device should display a prompt containing a passkey, enter “123456” and press ok.
  3. The device will now appear in the list of available payment devices within the SDK when the method getAvailablePinPads() is called.

ID TECH VP3350 IOS

  1. Turn the payment device on by pressing the power button on the side.
  2. Initialise the ChipDNA Mobile SDK and search for the payment device using the getAvailablePinPads() method.
  3. Pass in the selected payment device into the ChipDNA Mobile SDK’s connectAndConfigure() method.
  4. When prompted enter the passkey “123456” and press ok.

Wi-Fi

The SDK has the ability to connect to Wi-Fi capable devices. In order to do this the device must first be configured according to the manufacturer’s instructions to connect to a Wi-Fi connection and an IP address and port number obtained. It’s recommended that the PIN pad is configured to use a static IP and port number so that the IP address of the PIN pad doesn’t change. If the IP address were to change then the SDK would require re-configuration before a connection could be re-established to the PIN pad.

The SDK must then be configured by passing in the following parameter keys into the setProperties() method:

  • PinPadIpAddress – IP address configured on the PIN pad.
  • PinPadPort – port number configured on the PIN pad.
  • PinPadConnectType – With parameter value TcpIpConnectionType.
  • PinPadName – A PIN pad name in the same style as the Bluetooth name of the PIN pad. For example a Miura device with a serial number 020-1234567 would have the PIN pad name “Miura 567”.

Updated 4 months ago