IDTech VP8300

The JavaScript SDK supports an IDTech VP8300 card reader for payments acceptance. This card reader supports three interaction methods:

• Contactless
• Chip
• Swipe

Ensure the VP8300 card reader has a USB connection to communicate with the JavaScript SDK.

Prerequisites

Before using the VP8300 card reader, make sure you have the following:

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

Process payment

To process payment using the IDTech VP8300:

1

Add the ClearentSDK.init() function that has the enableReader flag set to true and the deviceType set to IDTECH.

ClearentSDK.init({
                  "baseUrl": "https://gateway-int.clearent.net",
                  "pk": "YOUR PUBLIC KEY GOES HERE"
                  "enableReader":true,
                  "deviceType": "IDTECH"
                 });

2

Plug the card reader into a USB port on your device.

Use an external adapter if your device does not have a USB port.

3

Select the Reader button next to the Card Number input field to complete the entry of card details into the fields of the payment form.

Payment form

4

Present the card when you see the Ready for card reader… message on the payment form.

Payment form

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.

The Payment Details section displays the masked information in the fields.

Payment form

To clear the information from all fields in the Payment Details form, select the Clear button in the upper-right corner.

5

Select the Submit Payment button.

Payment form

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 for more information.

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