Configure a local connection

Your point-of-sale (POS) can connect to the Clover Flex or Clover Mini using a local network connection or a cloud connection to the Clover servers. Local connection uses an embedded server within the REST Pay Display app on the Clover device to transfer messages between your POS app and the device. This section provides information on Clover device setup for local connection.

Prerequisites

Secure configuration

REST Pay Display uses a HTTP server on the Clover device so that it can establish a HTTPS (secure) connection.

Device server certificates for sandbox and production environments

Local connection requires your POS to trust the Clover certificate authority (CA) that has issued the HTTP server certificate. By default, the Clover Prod Terminal Server Root certificate authority (CA) issues the device server certificate. The certificate must be installed in the Trusted Root Certification Authorities store. If the certificate is not installed in the correct store, a certificate chain error message appears when you attempt to connect.

Clover provides separate certificates for development and production use. You need to enable the sandbox development certificate before working in the sandbox environment.

Sandbox/development device server certificateProduction device server certificate
Test merchants on the sandbox environment with devices running REST Pay Display need to have the device server certificate installed on the POS hardware. The Clover Device Server Root CA issues the device server certificate hosted at:

https://sandbox.dev.clover.com/v2/device_ca_certificate
https://sandbox.dev.clover.com/v2/device_ca_certificate.der
https://sandbox.dev.clover.com/v2/device_ca_certificate.crt
Note:
These are same links in different formats
Production certificates apply to your real merchants as well as the test merchants on production environments. The Clover Prod Terminal Server Root CA issues the device server certificate hosted at:

https://www.clover.com/v2/env_device_ca_certificate
https://www.clover.com/v2/env_device_ca_certificate.der
https://www.clover.com/v2/env_device_ca_certificate.crt
Note:
These are same links in different formats.

Change the device certificate for development

To enable the development certificate authority (CA) in the sandbox environment:

  1. In the REST Pay Display app settings, select the Enable Development Certificate option.
  2. Select Configure and Restart Server.
  3. Restart the server to update the certificate authority (CA).
  4. Select View Certificate Details and verify that the device certificate is issued by the Clover Device Server Root CA.

REST Pay Display settings on the device

All of the following procedures are for setting up REST Pay Display on the device on both sandbox and production environments, for test and real merchants.

🚧

Important

You must enable HTTPS connection in production. You can use non-encrypted HTTP connection for development and testing in the sandbox environment.

View the current certificate and server settings on the Clover device

  1. On the Clover device, tap View Certificate Details to verify that the device certificate is issued by the Clover certificate authority (CA).
  2. On the Clover device home screen, tap REST Pay Display.
  3. Tap the menu icon, and then tap Settings. The Clover Device Server settings appear. Note that the Enable Development Certificate checkbox is selected.
12501250

📘

Note

Pairing is not enabled for REST Pay Display so do not tap the Enable Pairing Screen check box.

Change the connection protocol on the device

The connection between a POS and Clover device is over HTTPS by default. As this is payment-related data, Clover strongly recommends using HTTPs. However, the Clover device server also supports non-encrypted HTTP connection that can be used only for development and testing. You must enable HTTPS connection in production.

To change the connection type on your device:

  1. On the Clover device home screen, tap REST Pay Display.
  2. Tap the menu icon, and then tap Settings.
    The Clover Device Server settings appear.
  3. Tap the Server is Secured checkbox to clear it.
  4. Tap Configure and Restart Server.
    The green lock icon next to the Server is Secure checkbox changes to red unlocked.
    On the REST Pay Display screen, the device URLs change from https:// to http://.

Change the server port on the device

By default, the connection between a POS and Clover device uses port 12346.
To change the port on your device:

  1. On the Clover device home screen, tap REST Pay Display.
  2. Tap the menu icon, and then tap Settings.
    The Clover Device Server settings appear.
  3. Tap Server Port. The Enter Server Port Number page appears.
  4. Enter a new port number.
  5. To change the device ping settings, edit one or more of the following values:
  • Enable ping—Selected checkbox enables the device to check that the connection is open at specified intervals.
  • Ping interval—Indicates length of time between pings, in milliseconds.
  • Ping retry before disconnect—Number of times the server attempts to ping the client before disconnecting.
  1. Tap Save.
  2. Tap Configure and Restart Server. The server port is changed.

📘

Note

If another process on the Clover device is using the new port a message displays that the address is already in use. You need to enter a different port number.