Android Framework

The Mobile EMV SDK enables Android apps to accept EMV chip card payments via Bluetooth or audio jack using the IDTech VP3300 card reader.

Prerequisites

To enable the Mobile EMV SDK into your iOS app, ensure you have following:

✅ API access key issued to you by Xplor Pay.

Visit Let's Get Started - Xplor Pay to get API access key.

1

Set up mobile card reader

To set up the mobile card reader:

1. Turn on the reader.

The reader must be fully charged before you turn it on.

1. Enable Bluetooth on your Android device.

The reader automatically pairs with your Android device when Bluetooth is on.

1. Insert the chip side of the card into the reader’s slot and wait until the green LED flashes.

This confirms a successful card read.

2

Connect Android app

To connect your Android app to the card reader:

1. Add the required .jar files from android-idtech-sdk/sdk/lib in your Android project.
2. Add the PublicOnReceiverListener object to receive messages from the card reader.
3. Add the ApplicationContext or ApplicationContext3In1 object to enable the card reader modes (DIP/SWIPE/CONTACTLESS).
4. Add the DeviceFactory object to connect your app with the VP3300 reader.
5. Configure the card reader.

device_configurePeripheralAndConnect();
registerListen();

1. Ensure the card reader is ready.

isReady(); // Wait for readiness before starting a transaction

3

Process payment

To process the payment in your Android app:

1. Initiate a card transaction.

device_startTransaction();

1. Generate a JSON Web Token (JWT) for manual card entry.

manualCardTokenizer.createTransactionToken(manualEntry);

1. Use the POST method to send the transaction request to the Mobile Payment Transactions endpoint to process the payment.