Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Deploy apps on your terminals

Upload apps to Adyen and make them available on your Android payment terminals.

On your Android payment terminal you can install and use Android apps. For example, a cash register app and an inventory maintenance app. This enables your staff to use a single device for checking the inventory, operating the cash register, and taking payments.

Here we give an overview of the deployment process and provide detailed instructions.

How it works

This is how you make apps available on your Android payment terminals:

  1. You create your Android app, making sure it meets the requirements
  2. You upload your app to us in your Customer Area.
    We sign the app, convert it to a format that the terminal can handle, and store it.
  3. If the app requires a certificate, you also upload the certificate in your Customer Area.
    We sign the certificate and store it.
  4. When signed and ready, you plan an action to install your app on the terminal.
    If applicable, you also plan an action to install the certificate on the terminal.

    You can plan actions manually in your Customer Area or make API calls.

  5. The app is installed and becomes available on the terminal when the terminal makes an automatic maintenance call to our system.

Requirements

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

    • Merchant POS Terminal Management Admin

  • 1.70 To install and uninstall certificates, the terminal must be on release 1.70 or higher.

Upload your app

Upload your app as follows:

  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 lower, select V1 (Jar Signature). We recommend also selecting V2 (Full APK Signature).
      • If your minSdkVersion is higher 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.
  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 cash register 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.

Upload the certificate as follows:

  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.

Install or uninstall apps

To add or remove an app on your payment terminals, you indicate in your Customer Area what action you want to take on what terminals. The terminals then carry out the action at an automatic maintenance call they make to our system. For the action to succeed, the terminal must be connected to your network and turned on.

To manage apps in your Customer Area, you must have the following user role:

  • Merchant POS Terminal Management Admin

Plan the action as follows:

  1. In your Customer Area go to Point of sale > Android and select the Apps tab.
  2. Verify that the app has reached the Ready status.
  3. Select the app.
  4. Select what you want to do:
    • Schedule installation to add an app to terminals.
    • Schedule uninstallation to remove an app from terminals.
  5. Select the app version.
  6. Plan when the install or uninstall action must happen:
    • Schedule now installs or removes the app with the next maintenance call.
    • Specifying a date and time installs or removes the app with the first maintenance call after the planned date and time.
  7. Select Continue.
  8. Select the terminals that you want to apply the action to. You can filter the list of terminals on terminal ID, or a combination of categories like terminal model, and country.
  9. Select Continue.
  10. Review the plan and select Schedule installation.

Install or uninstall certificates

To add or remove an Android certificate on your payment terminals, you indicate in your Customer Area what action you want to take on what terminals. The terminals then carry out the action at an automatic maintenance call they make to our system. For the action to succeed, the terminal must be connected to your network and turned on.

To manage certificates in your Customer Area, you must have the following user role:

  • Merchant POS Terminal Management Admin

Plan the action as follows:

  1. In your Customer Area go to Point of sale > Android and select the Certificates tab.
  2. Select what you want to do:
    • Install certificate to add a certificate to terminals.
    • Uninstall certificate to remove a certificate from terminals.
  3. Select the certificate.
  4. Select the terminals that you want to apply the action to.
  5. Depending on the chosen action, select Install or Uninstall.

Check apps on a terminal

To see which apps are currently deployed to a terminal:

  1. On the terminal, go to Settings > Apps.
  2. Enter your passcode.

    If an app is scheduled to be installed or removed, this action is carried out immediately when you open the Apps menu.

See also