Take payments

Perform transactions with a terminal from your Android mobile point-of-sale application.

Importing Android SDK

Import the SDK to your project by adding the following lines to your build.gradle file

Install the following plugins necessary for the SDK to function correctly in your build.gradle file.

Add the following repositories in your settings.gradle file.

Initializing SDK

Initialize the SDK by setting your user token and environment via the initSDK() method, as shown below

Property	Type	Required	Description	Allowed values
context	Object	Yes	android.content.Context
sdkMode	Object	Yes	InitBillpocketSDK.SdkMode.	`TEST`, `PRODUCTION`
userToken	String	Yes	User token.
deviceToken	String	NO	Device ID. It can be viewed and renamed from the Billpocket dashboard > My devices section.
listener	Object	Yes	EventListenerInitSDK

Send eventListener as an object that implements the EventListenerInitSDK interface to listen to the initialization result.

Connecting bluetooth reader

Link the terminal to your mobile device via Bluetooth so the SDK can find it. Get the available readers using the getListBluetoothReaders method.

Implement the resultListReaders method of the EventListenerConnection interface to listen to the result.

You will need to verify Bluetooth permissions for devices with an Android API Level lower than 31.

Implement the connectReader method to get the selected item from the list of available devices. Get the type, macAddress and name data from the previously selected BluetoothDevice object.

Implement the resultReaderConnect method of the EventListenerConection interface to get the connection result.

Request data model

These are all the parameters you can configure when making a request.

Propiedad	Type	Required	Description
context	Object	Yes	android.content.Context
amount	Number	Yes	Transaction amount.
description	String	Yes	Transaction description.
location	Object	Yes	Instance of the `android.location.Location` object with latitude and longitude of the transaction source.
tip	Number	No	Transaction tip
listener	Object	Yes	Instance of `EventListenerTransaction`.
rotationSignature	Boolean	No	Set `true` to display the signature screen vertically or set `false` to display the signature screen horizontally.

Operations

Discover all the operations available through Terminal SDK integrations.

Sale

Send a request with the required payment settings from your system to a terminal to perform the desired transaction.

Use the doTransaction method to initiate a transaction with the terminal. You must send all required parameters in the request.

Send an eventListener object which implements the EventListenerTransaction interface to listen for transaction events.

Learn how to implement deferred payments, disconnect a terminal, authenticate a transaction, and other available methods in the SDK documentation.

Response

Depending on the result, the response will be returned as one of the following callbacks.

onTransactionSuccessful

This method is called when the transaction is successful.

onTransactionFinished

This method is called when a magnetic stripe payment is made or an error has occurred during the transaction.

onTransactionAborted

This callback is called when the operation is cancelled. For example, it is called when the terminal is disconnected or the card reading time has expired.

Please review the SDK reference for more detailed information.

Test data

Make any necessary adjustments to your system using the test data.

Transactions

Get the list of transactions with information relevant to your operations.

Importing Android SDK#

Initializing SDK#

Connecting bluetooth reader#

Request data model#

Operations#

Sale#

Response#

onTransactionSuccessful#

onTransactionFinished#

onTransactionAborted#