Upload apps and certificates

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

Before installing apps on your Android payment terminals, you 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 manually upload your apps and certificates in your Customer Area.You can also make API calls to schedule terminal actions that install your apps and certificates on your payment terminals.

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, limitations, and preparations.

Requirement	Description
Integration type	A point-of-sale integration with Adyen using Android payment terminals.
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, make sure that you have the following role: Merchant POS Terminal Management Admin role
Limitations	Requests to live Management API endpoints related to Android apps and certificates are subject to rate limits.

Prepare the APK file

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

In Android Studio, select Build > Generate Signed Bundle / APK.
In the dialog, select APK and then Next.
Configure your key store details and select Next.
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).
Select Finish.

For more details, see the Android APK signing documentation.

Upload your apps

(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.