BBPOS Chipper 2X BT Setup

    Learn to use the BBPOS Chipper 2X BT mobile card reader with Stripe Terminal.

    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.

    Light Meaning
    None The reader is off.
    Flashing blue every second The reader is on and ready to connect to a device. (Will turn off after 5 min.)
    Multicolored flashing The reader has been discovered using Bluetooth Proximity and is ready to connect.
    Steady blue The reader is connected to a device.
    Flashing blue every 5 seconds The reader is in standby mode. (Will remain in standby indefinitely.)
    Alternating red and magenta The reader is charging.
    Flashing red The reader’s battery is low.
    Rapidly flashing blue and orange The reader has finished installing a software update. If the reader is unresponsive after the update completes, restart the reader by turning it off and on.

    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 app. The reader cannot update itself. Read about reader software updates for details.

    In your app, notify the user that an update is available, display whether the update is required, and provide a button to continue with the update. Failing to install a required update can prevent a reader from accepting payments.

    1. Use the checkForUpdate method to check for available updates, and the installUpdate method to install the update if one is available. See an implementation in our iOS or Android example apps.

    2. If an update is available, your app’s callback receives a ReaderSoftwareUpdate object containing update details, including an estimate of how long the update will take. In your app, notify users that an update is available, and display a prompt to continue with the update. Include the time estimate in your app’s UI.

    3. To proceed with the update, call installUpdate with the ReaderSoftwareUpdate object. 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.

    To test your app’s ability to install reader software updates, use the simulated reader. When you call the checkForUpdate and installUpdate methods with your application connected to a simulated reader, the SDK responds with the same events your application would receive when updating a physical reader.

    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 hyphens into a single string.

    Latest Version
    1.00.03.34-SZZZ_Generic_v40-30000

    Firmware versions

    Version Release Date Description
    1.00.03.34 2018/11/29 Adds the ability for the reader to beep when a card is inserted.
    1.00.03.32 2018/09/20
    1.00.02.31 2018/08/02
    1.00.02.30 The initial firmware version available for this device.

    Configurations

    Name Release Date Description
    SZZZ_Generic_v40 2019/05/29 Fixes an issue where certain Amex contactless transactions could not be read.
    SZZZ_Generic_v37 2018/11/20 Enables beeps when a card is inserted, the transaction is complete, and when a card is left in the reader.
    SZZZ_Generic_v36 2018/09/28 Enabled card insert and removal detection outside of a transaction.
    SZZZ_Generic_v35 The initial configuration available for this device.

    Key identifiers

    Identifier Release Date Description
    30000 The initial key identifier available for this device.

    Next steps

    Now that you have your reader set up, you might want to read about connecting it to your app, or try collecting your first Terminal payments with a physical reader.

    The BBPOS and Chipper™ name and logo are trademarks or registered trademarks of BBPOS Limited in the United States and/or other countries. The Verifone® name and logo are either trademarks or registered trademarks of Verifone in the United States and/or other countries. Use of the trademarks does not imply any endorsement by BBPOS or Verifone.

    Was this page helpful?

    Thank you for helping improve Stripe's documentation. If you need help or have any questions, please consider contacting support.

    Questions?

    We're always happy to help with code or other questions you might have. Search our documentation, contact support, or connect with our sales team. You can also chat live with other developers in #stripe on freenode.

    On this page