Clover Go SDK

United States

The Clover Go software development kit (SDK) allows developers to integrate their iOS® or Android apps with the Clover Go reader.

Clover Go SDK highlights

  • Provides simple integration to handle card present and card not present (manual entry) payments.
  • Includes feature parity with existing Go SDK, and backward compatibility with the legacy Ingenico RP450 reader for existing integrations.
  • Supports use cases for both merchant-built apps and ISV partners' apps.
  • Includes Android SDK and V1 iOS libraries.
  • Includes developer documentation and integration guides.

The new Clover Go SDK does not include the following:

  • Pre-built user interface (UI) screens to embed into a custom application.
  • Clover built app that handles payment on the end user's device.
  • Compatibility with responsive web apps running on mobile devices.

Prerequisites (sandbox)

Before you integrate with the Go SDK, complete the following:

  • Claim your Clover account and log in with your Clover credentials so that you can use the Clover standard OAuth flow for authentication.
  • Create and set up a developer account (including your test merchant settings) and an app in Clover sandbox Developer Dashboard.
  • Create at least one employee user to use within the OAuth flow.
  • Order a Clover Go reader Developer Kit (Dev Kit) and set it up.

Go device features

Card readers supported

  • Clover Go readers
  • Ingenico RP450 (legacy)



Clover Go readers support EMV Contact and Contactless (NFC). Mag-stripe is not supported.

Device operations

  • Get Clover Go reader battery level
  • Convenience method to handle:
    • Device initiation (key injection)
    • Bluetooth connection


Clover APIs support the following types of payment transactions: Sale, auth, or pre-auth; card-present through the device or manually entered through a payment form

Payment methodDescription"Final""Capture"
SaleClosed or settled payment that is final and is ready for capture. A sale cannot be adjusted for tips or captured later.truetrue
AuthOpen payment that can be tip-adjusted until closeout occurs. It is closed at the time of closeout.

tipAdjust requests require an existing transaction reference ID (paymentId) and the amount of tip to add to the original transaction.
Pre-authOpen payment that is captured later. Pre-auth request needs to be captured in the future. Once captured, it is closed at the time of closeout.

Pre-auths must be followed by a capture request for payment to be processed. Payment will not be received until after this request is made. The capture request must include all of the following:

- existing transaction reference ID (paymentId) for capture/completion
- amount to be captured
- optional tipAmount

Use a pre-auth request when a delay is needed between the time a transaction is started with a customer and when the payment completes. For example, pre-auths are appropriate for apps that facilitate online food orders, bar tabs, or other made-to-order goods. If a delay is needed between ordering and payment, then using the Sale (captured) payment method reduces the complexity of your app.
  • Forced Credit (refund without reference) for manual entry only



Accepting manually entered payments puts third-party apps in scope of payment card industry (PCI) compliance. Clover Go SDK solution handles client-side encryption of manual card entries using a Clover-issued certificate.

  • Reversal (void/refund with reference)
  • Capture a pre-auth
  • Tip adjust an auth
  • Closeout a batch
  • Send a Clover digital receipt

Development Specs

Development environmentXcode version: 14.2Target SDK versions: 23 - 32
OS Versions ValidatediOS 14 and above on your deviceAndroid version 7.1 - 12L and above on your device
SDK DistributionCocoaPodsMaven Central


Contact Clover developer support.