Terminal SDK

The Terminal SDK lets you integrate card-present payments directly into your Android app. Unlike App to App, the SDK does not require the Billpocket POS app to be installed — your app communicates with the terminal directly and you control the entire payment UI.

INFO

Available in Mexico only. Android only.

Guides

Android Integration

Step-by-step guide to import the SDK, initialize it with your user token, and process payments from your Android app.

Error Codes

Full reference of SDK error codes returned during payment processing, initialization, and terminal communication.

How it works

1. Import SDK into your Android project   (Gradle dependency)
2. Initialize with user token + env       (initSDK())
3. Connect to terminal                    (Bluetooth / USB)
4. Start a transaction                    (charge, void, refund)
5. SDK handles EMV processing             (card read, PIN, authorization)
6. Receive result in your callback        (approved / declined + ticket data)

Quick setup

Add the dependency to your build.gradle:

Initialize the SDK with your user token:

App to App vs Terminal SDK

	App to App	Terminal SDK
POS app required	✅	❌
Custom payment UI	❌	✅
Platform	Android, iOS, Web	Android only
SDK dependency	Optional (Intent builder)	Required

Requirements

A valid Billpocket account and user token

Android project with Gradle build system

Ultra, Ultra P, or Ultra SE terminal

Got a suggestion on this documentation? Contact us.

Guides#

How it works#

Quick setup#

App to App vs Terminal SDK#

Requirements#

Guides

How it works

Quick setup

App to App vs Terminal SDK

Requirements