Skip to main content
Version: 2.1

tt3-android-intents

TT3/DebiCheck using Android Intents

Integration with Halo.Go application for transactions using Android Intent Mechanism.

We provide a sample code to help you with the intent request function call. The code is available on GitHub.

Note: Experience with Android development is advised


Initiate a TT3 Intent Transaction

Retrieve a Transaction ID and payment JWT by hitting the endpoint below. You will need the API Key and Merchant ID from the previous step for this API call.


Post

{{POST_URL}}

The Call to initiate an TT3 Intent Transaction.


Headers

NameTypeDescription
Content-Type*StringContent Type of The Request: application/json
x-api-keyStringThe API Key retrieved from the Merchant Portal

Request Body

NameTypeDescription
merchantId*IntegerMerchant ID from Merchant Portal
paymentReference*StringReference of the transaction
amount*IntegerAmount of the transaction
timestamp*StringISO Standard Timestamp
currencyCode*StringISO Standard Currency Codes
packageName*StringIdentifier of the app

Response

201: Created TT3 Intent Transaction JWT

The response will contain a Transaction ID and JWT Token that will be used in the Intent call

Please see the example of the response body below:

{

"id": "ffe12ca8-61e6-48f9-b89c-537818652988",
"token":"eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9.eyJ1c3IiOiJoYWxvIiwiY
XVkX2ZpbmdlcnByaW50cyI6InNoYTI1Ni96YzZjOTdKaEtQWlVhK3JJE..."
}

Send an Intent Request to the Halo Dot Go App

Initialise the transaction through the startActivityForResult(Intent, int) function as shown in the sample app.