Upload apps and certificates

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 it as well.

Requirements

• To manage Android apps and Android certificates in your Customer Area, you must have the following user role:
  • Merchant POS Terminal Management Admin

Upload your app

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

2. In your Customer Area, go to Point of sale > Android and select the Apps tab.
3. Select Upload app.

   If you do not see the Upload app button, contact our POS Support Team to enable it.

4. In the dialog box:
   1. Drag the APK file to the upload box or select the box and choose the APK file.
   2. Optionally, enter a description of the app so that we can store this in our systems.
      On the terminal, we will use the app name that is included in the APK.
   3. Select the checkbox to opt in.
   4. Select Upload app.
5. Stay on the page until the dialog box closes.
   On the Android page, the Apps tab now shows the icon and APK name of your app.

6. Check the status of your app.

   Status	Description
   Processing	We are busy signing and converting the app. This can take up to an hour.
   Error	Something went wrong. Check that the app matches the specifications and retry uploading the APK file. If the retry attempt fails as well, contact our POS Support Team or your Adyen implementation manager.
   Invalid	There is something wrong with the APK file. Contact our POS Support Team or your Adyen implementation manager.
   Ready	We finished signing and converting the app. The app is ready for installation.

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

1. Make sure you have the certificate in .pem or .cert format.
2. In your Customer Area, go to Point of sale > Android and select the Certificates tab.
3. Select Upload new certificate.
4. In the dialog box:
   1. Drag the certificate file to the upload box or select the box and choose the certificate file.
   2. Enter the certificate name to show in the Customer Area.
   3. Optionally, enter a description of the certificate.
   4. Select Upload certificate.
5. Check that the Certificates tab now shows the name of your certificate, and the status Ready.

See also