Quick Start

This page helps you set up and process payments with the Xplor Pay Mobile EMV SDK. You can use the VP3300 mobile reader to accept card transactions securely in your Android app.

About Xplor Pay Mobile EMV SDK

The Xplor Pay Mobile EMV SDK enables Android apps to accept EMV chip card payments via Bluetooth or audio jack using the VP3300 card reader. This reduces your PCI compliance scope.

About VP3300 Mobile Card Reader

The VP3300 mobile card reader lets you process EMV and P2PE-compliant transactions using Bluetooth or audio-jack connectivity.

Prerequisites

To enable the Xplor Pay Mobile EMV SDK into your Android app, ensure the following prerequisites are met:

✅ API access key issued to you by Xplor Pay.

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

1

Set up VP3300 mobile card reader

To set up the VP3300 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 your Android app to the card reader

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 the payment in your Android app

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 payment request to the Xplor Pay Mobile Transactions API endpoint to complete the transaction using the tokenized payment data.