Terminal SDK Introduction

October 11, 2024

Terminal SDK lets you quickly and securely integrate a Nano, Ultra, or Ultra P terminal to your mobile point of sale (POS) system through our Android SDK. The SDK allows you to communicate directly and securely with a terminal to perform different operations. This integration will enable you to fully control the payment flow. You can perform sales or cancellation operations with this integration.

Features

Terminals

Below is the list of readers supported by Terminal SDK integrations:

• Nano
• Ultra
• Ultra P

Operations

These are the operations available for integrations through Terminal SDK:

• Sale
• Tipping
• Deferred payments
• Transaction search
• Voids and refunds

Supported card brands

The following card networks and brands are accepted through Terminal SDK integrations:

• Visa
• Mastercard
• Carnet
• American Express
• Sodexo
• Sí Vale
• Edenred

Requirements

Before you can perform an integration, you must meet the following requirements:

• Create a test account.
• Have a compatible and configured test terminal.
• Stable internet connection.
• Allow communication with our external services through firewalls and similar services.

Environments

Make any adjustments to your system by testing in a dev development environment. Remember that no real transactions will be processed in this environment.

When ready, you can switch to the live environment to process real transactions.

val sdkMode = InitBillpocketSDK.SdkMode.TEST
val userToken = "userToken"
BillpocketSDK.initSDK(context, sdkMode, userToken, eventListener)

When you are ready, you can switch to the production environment to process real transactions by setting the value of the sdkMode property to PRODUCTION.

val sdkMode = InitBillpocketSDK.SdkMode.PRODUCTION
val userToken = "userToken"
BillpocketSDK.initSDK(context, sdkMode, userToken, eventListener)

Process a payment

Import and configure the SDK within your project to start the integration. Discover all the operations you can perform with a terminal in the article Take payments.