Terminal-2 icon

Upload apps and certificates

Upload apps and certificates to Adyen for your Android payment terminals.

View source

To be able to install your app on your Android payment terminals, you first need to upload the app so we can convert it into a format that the terminals can handle. If an app also requires a certificate, you need to upload the certificate as well.

You can upload apps and certificates in your Customer Area or through API calls.

After uploading, you can install your app and certificate on your payment terminals using API calls or profiles, or manually using the Customer Area, as described on other pages.

By choosing to upload, install, or run any third-party applications on an Adyen payment terminal, you accept full responsibility and liability for any consequences of uploading, installing, or running any such applications.

Requirements

Before you begin, take into account the following requirements and limitations.

Requirement Description
Integration type A Terminal API integration with payment terminals or a standalone solution.
API credentials To upload apps and certificates using API requests, you must have an API credential with an API key and the following role:
  • Management API—Android apps/certificates read and write

If you have a Terminal API integration with cloud-based communications, you can use the existing API key that you use for Terminal API requests.
Customer Area roles To upload apps and certificates using the Customer Area, you must have the following role:
  • Merchant POS Terminal Management Admin role
Hardware Android payment terminals.
Limitations Take into account the following limitations:

Prepare the APK file

Before you upload apps to Adyen, you need to create a signed APK file of your app:

  1. In Android Studio, select Build > Generate Signed Bundle / APK.
  2. In the dialog, select APK and then Next.
  3. Configure your key store details and select Next.
  4. Select a build variant:
    • If your minSdkVersion is 23 or earlier, select V1 (Jar Signature). We recommend also selecting V2 (Full APK Signature).
    • If your minSdkVersion is later than 23, we recommend selecting V2 (Full APK Signature).
  5. Select Finish.

For more details, see the Android APK signing documentation.

Upload the app

(Optional) Upload the certificate

Some apps need a digital certificate. For example, a certificate to protect network communications between a POS app and the back end of that app. Such a certificate needs to be installed on the terminal, and replaced with a new one before the validity period of the certificate expires.

App upload and storage policy

We automatically delete apps from your Customer Area in the following cases:

  • Version limit reached: You can store a maximum of 50 versions for a single app. When you upload a new version of an app that already has 50 versions, the oldest uploaded version is deleted automatically.
  • Unused apps: Apps that are older than 2 years and not installed on any terminal are deleted automatically.

See also