Overview

The Payment Device SDK for iOS/Android allows developers to create software that integrates with mobile Bluetooth payment terminals. The SDK abstracts many of the complexities of interacting with terminals so that you can focus on building great apps.

The SDK works with the following payment terminal, which needs to be purchased through the merchant's gateway provider.

• BBPOS Chipper 2X BT
• BBPOS Chipper 3X BT
• ID Tech VP3350

The SDK also works with these additional payment devices but must be purchased by contacting support.

• Miura M020
• Miura M021

Current SDK Version (Android): Familiar (3.16.3) replacing Familiar (3.16.2)
Current 3.X.X-LTS SDK Version (iOS): Familiar (3.16.3) replacing Familiar (3.16.2)

An Impundulu is a mythical bird in Zulu culture and is often the Familiar of a human.

Current SDK Version (iOS): Starfish (4.0.4) released replacing Starfish (4.0.2)

In ancient Greek folklore, Starfish served as talismans of protection and safe passage across the waves.
This release debuts Tap To Pay which allows transactions to be run on Commercial Off The Shelf (COTS) devices. COTS also being an abbreviation of the Crown Of Thorns Starfish.

Integration Guide

Document Version: 4.4 | Date: 23 May 2025

This document provides a high-level description of the API for integrating the Payment Device SDK for iOS/Android into a POS application.

Throughout this guide, you will notice several visual indicators and styles used to emphasize important information:

Critical information that must be obeyed to ensure success or avoid significant problems.

Key information that you should check you understand fully before continuing.

Hints and tips to help you act more effectively or avoid common mistakes.

References to further information outside this guide, such as international standards and useful Internet addresses.