Android app integration
ToP (Tap-on-Phone) is for Android devices with Android OS 8.1 or above and for Apple devices with iOS 11 or above
Messages
The client app must implement a mechanism to send messages using Android intents and URI calls and to receive the result in a custom URI callback. Overall the following messages are available:
- Sale request originating from the client app to initiate a request for a new Sale transaction.
- Sale response originating from the card terminal app to return the result of a Sale transaction.
- Cancel request originating from the client app to initiate a request for a Cancel transaction.
- Cancel response originating from the card terminal app to return the result of a Cancel transaction.
- Abort request originating from the client app to abort (if possible) the last Sale request.
- Abort response originating from the card terminal app to return the result of an Abort request.
- Printing settings request originating from the client app to change the Printing Settings.
- Printing settings response originating from the Card terminal app to return the result of a Printing settings request.
- Foreground request originating from the client app to bring Card terminal app to foreground.
- Send logs request originating from the client app to trigger the application to upload logs
- Send logs response originating from the card terminal app to return the result of a Send Logs request
- Batch request originating from the client app to open or close a batch.
- Batch response originating from the card terminal app to return the result of a Batch request.
- POS Activation request originating from the client app to trigger the POS activation.
- POS Activation response originating from the card terminal app to return the result of the POS activation request.
Callback activity
The client app must provide a callback activity declare in AndroidManifest.xml
, in order to receive the response results.
<activity
android:name="com.example.URLResponseActivity"
android:label="Payment Result">
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<action android:name="com.example.URLResponseActivity"/>
<category android:name="android.intent.category.DEFAULT"/>
<category android:name="android.intent.category.BROWSABLE"/>
<!-- Provide your own scheme here and reference it when you send a message -->
<data
android:scheme="mycallbackscheme"
android:host="result"/>
</intent-filter>
</activity>
Key to card terminal product categories
To understand the icons used in the every request/response, see the below table.
Get Support
If you have any questions about our solutions, or questions about how to integrate with our solutions, please refer to our Get Support page.