Use Clover Developer Kits (Dev Kits)

United States
Canada
Europe
Latin America

Clover Developer Kits (Dev Kits) are Clover devices with special permissions. You can use Dev Kits to:

  • Simulate transactions in a sandbox environment. See Clover developer environments. The sandbox environment allows you to test apps in preparation for later deployment on the production server.
  • Experience transactions end-to-end from both the merchant and customer perspectives.
  • Run published apps and allows non-root connections with Android Debug Bridge (ADB). See Use Android Debug Bridge over USB or Wi-Fi.

Best practices to work with Dev Kits

  • Dev Kits are only for use in the sandbox environment.
    • You cannot re-provision your Dev Kit between the sandbox and production environments.
    • You cannot migrate your developer and merchant accounts between the sandbox and production environments.
  • Be careful when using Europay, Mastercard, and Visa (EMV) credit cards. Repeatedly inserting an active EMV credit card into an EMV-enabled development device that is pointed to a blackhole payment gateway may cause the credit card to be disabled. This is because of EMV protections against repeated inserts that do not result in actual payments.
  • For best practices on using Clover devices, see device-specific storage guidelines.

Set up Devices and Dev Kits

For information on setting up specific Clover devices and Dev Kits, see Quick Start Guides on Clover Help - Set up your Clover Device.

For online help, see:

📘

NOTE

  • Clover Flex Dev Kit includes a hub with ports for power, USB type B, and Ethernet to aid in development and testing. This hub replaces the charging cradle shipped with merchant devices.
  • Clover Go Dev Kit does not need to be associated with a merchant account.

Order a Dev Kit

Clover can directly ship Dev Kits only to United States (US) addresses. Developers outside the US must use a package or freight-forwarding service to ship Dev Kits to their non-US addresses. See Receive Developer Kits at non-US addresses.

  1. Go to Clover Developer Kits.
  2. Add one or more Dev Kits to your cart on Clover Developer Kits and check out.
  3. Enter your US shipping address in the shipping details.
  4. Complete the payment, verify your email address, submit your order, and make a note of the order number from Clover for reference and tracking.

Once you have placed your order and received your Dev Kit, use the accompanying guide to familiarize yourself with the hardware. The guide is also available on Clover Help. You can then associate your Dev Kit with a test merchant account in the sandbox environment.

Associate your Dev Kit with a test merchant account

After you set up your Clover sandbox account, associate your Clover Dev Kit, other than Clover Go Dev Kit, with your test merchant account.

Prerequisite

  • Order and receive your Clover Dev Kit.
  • Set up your Clover Sandbox account.

Steps

  1. Unbox and power on your Dev Kit.
  2. Log in to the sandbox Developer Dashboard.
  3. From the left navigation menu, click Dev Kits. The Dev Kits page appears.
  4. Click Associate Dev Kit. The Associate Dev Kit page appears.
  5. Enter the Dev Kit serial number from the sticker on your Dev Kit box, for example: C012UQ12345678.
  6. From the Test Merchant drop-down list, select a test merchant account.
  7. Click Associate Dev Kit.
  • An activation code displays on the page.
  • Clover also sends you an email with a code to your development account.
  1. Use the code to activate the Dev Kit for the selected test merchant account, within 30 minutes of receiving the authentication code.

🚧

IMPORTANT

Clover disables the activation code after 30 minutes. Repeat these steps to generate new activation code.

Activate your Dev Kit

After you have associated your Dev Kit with a test merchant account, complete the setup and activation steps for your Dev Kit.

As part of your on-screen Dev Kit set up, you are not charged for selecting a merchant service plan. The activation process takes a few minutes. Once the Dev Kit is activated, Developer Dashboard—Dev Kits page displays an update.

Reassociate your Dev Kit with another test merchant account

As part of your app development in sandbox, you can create multiple test merchants with different configurations. To reassociate your Dev Kit with another test merchant:

  1. Log in to the sandbox Developer Dashboard.
  2. From the left navigation menu, click Dev Kits. The Dev Kits page appears.
  3. Click Reassociate Dev Kit from the submenu that displays for your associated Dev Kit. The Reassociate Dev Kit pop-up appears.
  4. From the Test Merchant drop-down list, select a test merchant.
  5. Click Reassociate Dev Kit.
  • An activation code displays on the page.
  • Clover also sends you an email with a code to your development account.
  1. Use the code to activate the Dev Kit for the selected test merchant account.

Disassociate your Dev Kit from a test merchant account

  1. Log in to the sandbox Developer Dashboard.
  2. From the left navigation menu, click Dev Kits. The Dev Kits page appears.
  3. Click Disassociate Dev Kit from the submenu that displays for your associated Dev Kit. The Disassociate Dev Kit pop-up appears.
  4. Click Disassociate Dev Kit. The Dev Kit is not associated with any test merchant account. You can associate your Dev Kit with another test merchant account.

Frequently asked questions