Running the Clover Go Android SDK sample app

Initial SDK setup

1. In Android Studio, create or open your own project.
2. Clone remote-pay-android-go into a separate project.
3. Using Finder (Finder/Explorer), copy the roam folder into the root of your project.
4. Update your settings.gradle file to include the roam module. It will look something like the following:
   include ':roam', ':<your_app_module_name>
5. In your project’s build.gradle file, add the mavenCentral() repository in the buildscript block:

buildscript {
  repositories {
    mavenCentral()
    jcenter()
    google()
  }

6. In your app module’s build.gradle file, add the following dependencies for roam and remote-pay-android-go-connector:

dependencies {
  ...
  api project(':roam')
  implementation ("com.firstdata.clovergo:remote-pay-android-go-connector:[email protected]") {
    transitive = true
  }
}

7. In your GoStartupActivity.java, set your demoAccessToken, goApiKey, goSecret, oAuthClientId, and oAuthClientSecret for the sandbox environment:

goApiKey = "Get this value from your DevRel representative";
goSecret = "Get this value from your DevRel representative";
demoAccessToken = "Access token generated with the OAuth flow";
oAuthClientId = "Clover app ID";
oAuthClientSecret = "Clover app secret";

Important sample code to review

Once you have your app module created, you can look at the remote-pay-android-example-pos activities, such as StartupActivity and ExamplePOSActivity, to see how the Clover or Clover Go connectors are created and implemented. The ExamplePOSActivity also has listener implementations you can reference.

The remote-pay-android-connector module contains the connector implementations for both Clover (CloverConnector) and Clover Go (CloverGoConnector). CloverConnector is used with the Clover Mini and Flex. CloverGoConnector is used with standard Android phones and tablets using Clover's audio jack (RP350) and Bluetooth (RP450) card readers.