BBPOS Chipper 2X BT setup

The BBPOS Chipper 2X BT is a handheld reader for use with mobile applications. It uses Bluetooth Low Energy (LE) to connect to the Stripe Terminal SDK on a mobile device.

This reader is compatible with iOS and Android SDKs. To view the reader’s parts and features, see the BBPOS Chipper 2X BT product sheet.

Turning the reader on and off

To turn on the BBPOS Chipper 2X BT, press and release the power button. The status light turns on to indicate power. The reader waits for a Bluetooth connection for five minutes before turning off.

When the reader is connected to a device running your app, its status light shines steady blue. If inactive for more than 30 seconds, it enters standby mode to conserve power, and the status light begins flashing at 5-second intervals. The reader stays connected to your iOS or Android device while in standby and automatically exits standby mode when you resume activity.

The reader automatically turns off after 10 hours of inactivity. To turn the reader off manually, press and hold the power button until the status light goes out. You don’t need to turn off the reader to conserve power.

Status light

Whenever the BBPOS Chipper 2X BT is turned on, the LED located beside the power button shows the reader’s current status.

Charging the reader

To charge the BBPOS Chipper 2X BT, use the included micro USB cable. The USB port does not work for connecting the reader to a device—it’s only for charging.

Updating reader software

You must support updating the BBPOS Chipper 2X BT from your application. The reader cannot update itself. These updates include regional configurations that keep you up to date with card network and issuer requirements, as well as potential security updates. Required updates will start installing on connection to the reader and must complete before the reader can be used.

Required updates

import UIKit
import StripeTerminal

class ReaderViewController: UIViewController, BluetoothReaderDelegate {

    // ...

    // MARK: BluetoothReaderDelegate

    func reader(_ reader: Reader, didStartInstallingUpdate update: ReaderSoftwareUpdate, cancelable: Cancelable?) {
        // Show UI communicating that a required update has started installing
    }

    func reader(_ reader: Reader, didReportReaderSoftwareUpdateProgress progress: Float) {
        // Update the progress of the install
    }

    func reader(_ reader: Reader, didFinishInstallingUpdate update: ReaderSoftwareUpdate?, error: Error?) {
        // Report success or failure of the update
    }

    // ...
}

You can cancel required updates using the Cancelable object. However, this will result in a failed connection to the reader. For incremental-only updates no Cancelable is provided as these updates can not be canceled.

Optional updates

Optional updates can be deferred, but will become required updates if not installed by a certain date. Optional updates will be announced to your BluetoothReaderDelegate at any time the reader is connected but not performing a transaction. If an optional update is available, your application’s BluetoothReaderDelegate will receive the didReportAvailableUpdate callback with the ReaderSoftwareUpdate object containing the update details. This update is also stored on the reader object as reader.availableUpdate, and is the update that will be installed when calling Terminal.installAvailableUpdate. The update object includes an estimate of update duration (estimatedUpdateTime) and the future date at which the update must be installed (requiredAt).

In your application, you should notify users that an update is available, and display a prompt to optionally continue with the update.

To proceed with the update, call installAvailableUpdate, which will install the update previously reported via didReportAvailableUpdate.

As the update proceeds, block the user from leaving the page in your app, and instruct the user to keep the reader in range and powered on until the update is complete. We recommend also providing your user with a visual indicator of the update’s progress. The BluetoothReaderDelegate reports the updates progress via the didReportReaderSoftwareUpdateProgress method.

When an optional update’s requiredAt date has passed, the update will not be installed until the reader is disconnected and reconnected.

import UIKit
import StripeTerminal

class ReaderViewController: UIViewController, BluetoothReaderDelegate {

    // ...

    // MARK: BluetoothReaderDelegate

    func reader(_ reader: Reader, didReportAvailableUpdate update: ReaderSoftwareUpdate) {
        // An update is available for the connected reader. Show this update in your application.
        // This update can be installed using `Terminal.shared.installAvailableUpdate`.
    }

}

See Testing Bluetooth reader updates to learn more about making sure your application handles the different update types that a reader can have.

Reader software releases

The software on the BBPOS Chipper 2X BT consists of three components: a firmware version, a configuration name, and a key identifier. The reader software version joins these three components with underscores into a single string.

Firmware versions

Configurations

Key identifiers