Skip to main content

Android application for payment terminal

Developing third-party Android applications for the NEXGO payment terminal is no different from developing for regular Android devices (smartphones).

Communication between a third-party application and the payment application is implemented using intent calls according to the "Payment application" specification. The interface provides the ability to invoke financial operations such as payment, refund, and transaction reversal, as well as service operations such as settlement, handshake, and parameter updates. After performing a given task, the payment application returns the result of the operation to the parent application in JSON format.

Third-party applications can also access terminal peripherals such as a printer. Access is provided through the NEXGO SDK, which offers an API interface for accessing individual peripherals.

The distribution and installation of third-party applications differs from regular Android devices for security reasons. Any production version of an application is distributed and further updated through our special pre-installed Switchio Store application, not from the standard Play Store. Based on the ID of a given payment terminal, the appropriate application will be installed or updated.

In case of a request to introduce a new application or update an existing one, you need to provide our company with:

  • your app file in .apk format,
  • short documentation at least in the scope of how to invoke all types of payment transactions that the delivered application integrates,
  • any login credentials (if needed for testing the application).

We will test the application, ensure it is signed with a special security certificate, and proceed with its distribution to the requested payment terminals.

To include an application in the Switchio Store, the following information must be provided:

  • official application name
  • version
  • short description (max 80 characters, preferably shorter)
  • long description (max 180 characters)
  • icon in .ico format, dimensions 134×134 px
  • APK file – size up to 70 MB

Alternatively, you can provide the signed version of the application to its author if they want to handle distribution to client terminals themselves (for example, in the case of private or closed business systems, etc.).

The above procedure applies to production payment terminals. For development purposes, a payment terminal can be provided in so-called debug mode, which allows you to develop and locally upload applications in the standard way used for regular Android devices.

The currency code (currencyCode) is based on ISO-4217; we currently support EUR (978) and CZK (203) currencies. A complete list can be found here.

API documentation – ECR protocol for download here. (payment)

NEXGO SDK API documentation for download here. (printer, QR reader)

NEXGO SDK (nexgo-smartpos-sdk-vx.x.x_yyyymmdd.aar) for download here.