Verifone Carbon Instructions

Document created by gjsissons on Sep 23, 2016Last modified by gjsissons on Oct 24, 2016
Version 13Show Document
  • View in full screen mode


About Carbon


You can develop HTML and Android applications for Carbon.  HTML applications run on the smaller display at the consumer side of a transaction. Android applications run on the larger display at merchant side on the Verifone Carbon device itself. We call these as Terminal Commerce Applications and Android Commerce Applications respectively.


The instructions below explain how to setup a Windows-based development environment, and build and install some sample applications.


Android Developer Environment Setup


Verifone has the made the SDK available for us to use at a Dropbox link here -


The installation file includes both the Android Studio 2.1.3 as well Verifone Commerce Applications SDK plugin. If you already have Android Studio installed, make sure it is version 2.1.3. If not, please remove current Android Studio version before running the Verifone provided executable above to install Android Studio and the SDK.  Please note that the Commerce Applications SDK on Android Studio 2.2 may have issues at this time.


SDK Installation


  • The pre-release VeriFone Commerce Application SDK can be run on a PC with a Windows 7, 8 or 10 Operating System.
  • The SDK is a plugin for the Android Studio IDE. The SDK is not compatible with Mac computers OS X operating system, it requires Windows OS.
  • The procedure below involves downloading the executable setup file and executing it. You will need to disable any virus checking or security software before you do this. You should install the SDK Verifone has the made the SDK available for us to use at a Dropbox link here.
  • You can download the SDK either locally or to your own Dropbox account.


You will know the installation was successful if you see a VeriFone menu appear on your Android Studio instance as shown below:




HTML Documentation for the SDK in a zipped file at this temporary location:


You will want to download and unzip the Developer's Guide so that you have access to all the documentation.


Open the index.html file with your browser to access the VeriFone Carbon Developer documentation.




Terminal Commerce Applications


Terminal Commerce Applications are targeted for all payment terminals as well for the consumer side of the integrated point-of-sale (POS).


Terminal Commerce Apps are HTML/CSS/JS based but security requirements on payment terminals set some limitations compared to standard web applications. As examples:


• Only authentic and locally installed HTML documents can be used.

• Navigation to external pages is not allowed.

• There is a separation of static HTML/JS code and data

• Dynamic data is filled in to the HTML page before rendering using XML processing instructions

• The Script terminates before the dialog is displayed at all. Therefore, it has no access to the HTML DOM and cannot update elements while a dialog is shown

• Use of external JS library components is not allowed


Android Commerce Applications


Android Commerce Applications are targeted for the merchant side of the integrated point-of-sale (POS). Android Commerce applications are implemented with Java using the Verifone Payment API. Android Commerce Applications can have a companion HTML application running on the consumer side enabling consumer-merchant interaction. These applications are referred to as Dual Screen Android Commerce Applications. One can also implement pure Android applications using only the APIs provided by Google.


Terminal Commerce Application Development


To create a Hello World Terminal Commerce application:

  • Start by selecting ‘Start a Verifone Commerce Project’ in the Android Studio Welcome Window.
  • Select the application type to be developed, Terminal Commerce app or Android Commerce app. (in this example select Terminal Commerce app)
  • Define a name for your application
  • Select the supported device family. Device families are defined according the terminal display resolution on these devices.
  • Open the Storyboard to begin designing your Hello World application. Click New HTML File to define the first pages. You can pick a ready made page template, or select a Blank template
  • Transitions between the pages as well triggers to wake up the Commerce Application can be defined in this storyboard.


Application Simulation


After you have designed your application, it is time to test your application by running it in the simulator. First you need to define the Configurations for the simulator.


  • There are multiple ways to do this. Select "Unnamed"', "'Run" or click on the green triangle.
  • Press the green + button on left upper corner to define configurations for your app
  • A window will be opened where you can update the Trigger and CP API payload values. By editing the field values you can simulate the payment application, and test your application with variable payload data values. After desired payload values are updated, press Run.
  • Select which of the supported display resolutions will be tested.


Setting up the Carbon Test Terminal


Connect a standard USB cable between your PC and the micro USB port in tablet side of the Carbon device.


Application installation


  • Launch the Package Upload service on the tablet by clicking the package upload icon on the desktop view
  • Select Run command in Android Studio
  • Select Terminal option instead of Emulator
  • The Application will be installed to the device
  • Wait until the Android Studio shows a confirmation message for successful app installation. This may take up to couple minutes
  • Reboot the Carbon device to launch the app


Installing Android .apk files on a test terminal:


  • Connect USB cable between tablet side of the Carbon device and your laptop
  • Use adb -commands to install apps (see ADB installation guide below)



For convenience, pre-release guides and SDKs are provided in a DropBox below so that software can be easily shared. Please note that in order to download the Verifone Commerce Applications SDK (which is an executable file) you may need to temporary disable your firewall or security software.




Privacy Policy, Copyright Notices, and Terms of Use

NAO, NAOqi and Choreographe are registered or unregistered marks belonging to their respective owners who are unaffiliated with and do not endorse or sponsor Vantiv, and Vantiv likewise does not endorse or sponsor Softbank Robotics or Aldeberban.