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 iOS app.

About Xplor Pay Mobile EMV SDK

The Xplor Pay Mobile EMV SDK enables iOS 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 iOS 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 iOS device.

The reader automatically pairs with your iOS 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 iOS app to the card reader

To connect your iOS app to the card reader:

1. Install SDK dependencies, such as IDTech.xcframework , IDTech.bundle (v4.0.142 or later) and CocoaLumberjack.xcframework .

2. Add the iOS Framework to your project using Carthage.

github "Clearent/iOS-framework"
carthage update

1. Import the iOS framework header in your code.

#import <ClearentIdtechIOSFramework/ClearentIdtechIOSFramework.h>

1. Initialize the SDK and connect to the VP3300 reader.

ClearentConnection *connection = [[ClearentConnection alloc] initBluetoothSearch];
                                  [clearentVP3300 startConnection:connection];

The iOS Framework connects automatically to the VP3300 reader using Apple’s Bluetooth implementation through the IDTech library.

The reader’s middle LED flashes green when successfully paired.

3

Process the payment in your iOS app

To process the payment in your iOS app:

1. Configure the SDK to initiate an EMV card transaction that sends the encrypted token to Xplor Pay.

ClearentVP3300Config *config = [[ClearentVP3300Config alloc] init];
[config setPublicKey:publicKey];
[config setClearentBaseUrl:baseURL];
config.contactAutoConfiguration = false;
config.contactlessAutoConfiguration = false;
config.contactless = true;
clearentVP3300 = [[Clearent_VP3300 alloc] initWithConnectionHandling:self
                                    clearentVP3300Configuration:config];
clearentManualEntry = [[ClearentManualEntry alloc] init];
[clearentManualEntry setClearentBaseUrl:baseURL];
[clearentManualEntry setPublicKey:publicKey];

1. Set up a payment request.

ClearentPayment *payment = [[ClearentPayment alloc] init];
[payment setAmount:theAmount];
payment.amtOther = 0;
payment.type = 0; // Sale
payment.timeout = 10;
payment.tags = nil;
payment.fallback = true;
payment.forceOnline = false;

1. Initiate a card transaction.

ClearentResponse *response = [clearentVP3300 startTransaction:payment
                                         clearentConnection:connection];
if (response.responseType != RESPONSE_SUCCESS) {
    // Notify user transaction could not be started
}

The Xplor Pay Mobile EMV SDK reads the card and encrypts the card data.

1. Handle the success callback to receive the message from the Xplor Pay Mobile EMV SDK.

- (void)successTransactionToken:(ClearentTransactionToken *)token {
    // Send the encrypted JWT to the Mobile Payments API
    // POST /rest/v2/mobile/transactions/sale
}

The Mobile EMV SDK returns an encrypted JSON Web Token (JWT) that contains the transaction data.

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.