Using IDTech VP8300
JavaScript SDK supports an IDTech VP8300 card reader for payments acceptance. This card reader supports three interaction methods:
Contactless
Chip
Swipe
Note: Ensure the card reader has a USB connection to communicate with JavaScript SDK.
Prerequisites
Follow the requirements below before you start using the VP8300 card reader:
Use a device with Windows or macOS that includes a USB port.
Serve your application over HTTPS in both development and production environments.
Your domain must have a valid SSL certificate.
Implement the manual card entry of the JavaScript SDK solution.
Initializing the SDK
Call the following init
function that has the enableReader
flag set to true
and the deviceType
set to IDTECH
, which supports the card reader.
ClearentSDK.init({
"baseUrl": "https://gateway-sb.clearent.net",
"pk": "YOUR PUBLIC KEY GOES HERE"
"enableReader":true,
"deviceType": "IDTECH"
});
Connecting the Card Reader
Plug the card reader into a USB port on your device.
Note: You can use an adapter if your device does not have a USB port.
Selecting the Reader Button
Selecting the Reader button next to the Card Number input field completes the entry of card details into the fields of the Payment Details form.

Presenting Card to Reader
Present the card when you see the message ‘Ready for card reader…’ on the Payment Details form.

Note: Do not present the card to the reader unless you see the message ‘Ready for card reader…’ on the Payment Details form to avoid incorrectly filling the card data into the fields.
You will see masked information in the fields of the Payment Details form.

Note: To clear the information from all fields in the Payment Details form, select the Clear button in the upper-right corner.
Selecting the Submit Button
To send the card data to Xplor Pay, select the Submit Payment button.

Note: The success
and error
functions are triggered when you call the mobile JWT or ACH mobile JWT to create a secure JWT, which presents the card or ACH data. See ACH Transaction Integration for more information.
Connecting in HID Mode
When you connect to the VP8300 in HID mode, a security window appears in your browser. This window allows you to select the terminal for connecting to the VP8300 in HID mode, enabling access to the VP8300 device.
Before connecting to the VP8300 in HID mode, you must:
Last updated
Was this helpful?