# 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:

:white\_check\_mark: API access key issued to you by Xplor Pay.

{% hint style="info" %}
Visit [Let's Get Started - Xplor Pay](https://xplorpay.com/getting-started/) and get API access key.
{% endhint %}

{% stepper %}
{% step %}

### **Set up VP3300 mobile card reader**

To set up the **VP3300** mobile card reader:

1. Turn on the reader.

{% hint style="warning" %}
The reader must be fully charged before you turn it on.
{% endhint %}

2. Enable **Bluetooth** on your Android device.

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

3. 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.
{% endstep %}

{% step %}

### 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.

{% code overflow="wrap" lineNumbers="true" %}

```javascript
device_configurePeripheralAndConnect();
registerListen();
```

{% endcode %}

6. Ensure the card reader is ready.

{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}
{% endstep %}

{% step %}

### Process the payment in your Android app

To process the payment in your Android app:

1. Initiate a card transaction.

{% code overflow="wrap" lineNumbers="true" %}

```javascript
device_startTransaction();
```

{% endcode %}

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

{% code lineNumbers="true" %}

```javascript
manualCardTokenizer.createTransactionToken(manualEntry);
```

{% endcode %}

3. Use the POST method to send the payment request to the [Xplor Pay Mobile Transactions API](https://docs.xplorpay.com/api-references/api-reference/payments/mobile/mobile-payment-transactions/mobile-transactions) endpoint to complete the transaction using the tokenized payment data.
   {% endstep %}
   {% endstepper %}