Using IDTech VP8300

Clearent’s 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 Clearent’s 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 Clearent’s 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 Clearent, 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 data.

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:

• Set the VP8300 Card Reader to HID mode.
• Enable the is-hid-reader-enabled field on the terminal of your public key.