- About Carbon
- Android Developer Environment Setup
- SDK Installation
- Terminal Commerce Application Development
- Application Simulation
- Setting up the Carbon Test Terminal
- Application installation
- Installing Android .apk files on a test terminal:
- Links of Interest
- Legal Stuff
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 - https://www.dropbox.com/s/5fs55dmbrbn22uk/Commerce%20Apps%20SDK.exe?dl=0
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.
- 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: https://www.dropbox.com/s/s29k9bqvo3704po/Developer%20Guide.zip?dl=0
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.
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.
- 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)
Links of Interest
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.
- Verifone Commerce Applications SDK (includes Android Studio) - https://www.dropbox.com/s/5fs55dmbrbn22uk/Commerce%20Apps%20SDK.exe?dl=0
- Developer Guide - https://www.dropbox.com/s/s29k9bqvo3704po/Developer%20Guide.zip?dl=0
- ADB installation Guide - https://www.dropbox.com/s/u8xjt5jvfeu1i1l/Windows_Setup_Configuration.docx?dl=0
- Guide on POS app development - https://www.dropbox.com/s/q3j9c53vv974wpa/POS%20app%20development.pdf?dl=0
- Verifone POS API spec https://www.dropbox.com/s/jhsu4ppg99gcf0x/docs-vantiv-hackathon.zip?dl=0
- Android Commerce sample app & Terminal Commerce sample apps
- Android Studio sample apps can be found in the SDK, look for Verifone-menu item.
- Rate Test, simple survey app - https://www.dropbox.com/s/45p6mdevz4vpbop/RateTest-9947960931-1.0.0.zip?dl=0
- Localization example - https://www.dropbox.com/s/cbb2rvf7n927rlb/Localiztn-865891275-1.0.0.zip?dl=0
- Triggers example - https://www.dropbox.com/s/zqkw39erybmal1a/CTAppNo01-CTAppNo01-1.0.0.zip?dl=0
- Instructions for running the Recharge POS sample app in the simulator https://www.dropbox.com/s/xxj0ljgadpukkjo/RechargeApp.pptx?dl=0
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.