# Android Framework

The **Mobile EMV** SDK enables Android apps to accept EMV chip card payments via Bluetooth or audio jack using the [IDTech VP3300](https://app.gitbook.com/s/ek5aF2vccbKrklw8djdB/devices/id-tech#id-tech-vp3300-reader) card reader.

### **Prerequisites** <a href="#prerequisites" id="prerequisites"></a>

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

✅ API access key issued to you by Xplor Pay.

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

{% stepper %}
{% step %}

### Set up mobile card reader

To set up the 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.

{% hint style="success" %}
The reader automatically pairs with your Android device when Bluetooth is on.
{% endhint %}

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

{% hint style="success" %}
This confirms a successful card read.
{% endhint %}
{% endstep %}

{% step %}

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

{% code lineNumbers="true" %}

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

{% endcode %}

6. Ensure the card reader is ready.

{% code lineNumbers="true" %}

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

{% endcode %}
{% endstep %}

{% step %}

### Process payment

To process the payment in your Android app:

1. Initiate a card transaction.

{% code 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 transaction request to the [Mobile Payment Transactions](https://app.gitbook.com/s/j9heLdoDRsfnChUQohvj/api/payments/mobile/mobile-payment-transactions "mention") endpoint to process the payment.
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xplorpay.com/quick-starts/android-framework.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.