Customize your Android payment terminals with themes

You can create multiple themes to customize the appearance of your Android payment terminals. This allows you to reflect your brand identity and showcase promotions during the payment flow. You can also customize these themes for specific terminal models, and apply them at the company or merchant account level or at the level of a specific store or terminal.

If you do not create and apply your own theme, the Adyen theme with the Adyen logo and dark mode is used.

Requirements

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

How it works

When you have your logo, image, and video files available that match the requirements:

1. You create your theme in your Customer Area at the company or merchant account level:
   1. You define the general settings for your theme by uploading a logo and selecting dark or light mode.
   2. You check the preview for each of your terminal models, and optionally upload different or additional images or videos for the various models.
2. You apply the theme at the desired level in your Customer Area: company or merchant account, store, or individual terminal.

Create a theme

To create a general theme in your Customer Area:

1. Log in to your Customer Area and make sure you have selected the company or merchant account that you want to create a theme for.

2. Go to In-person payments > Themes.

3. Select Create theme.

4. On the tab for the General appearance:

   1. Give your theme a name,
   2. Upload an SVG image for your Logo that applies to home, payment, and shopper engagement screens.
   3. Select a Light or Dark mode for the Appearance.

5. Select Save.
   You have now defined general settings for your theme.

6. Go to the tab for a terminal model, check the previews for the various screen types, and decide if you need to customize the theme for the combination of terminal model and screen type.

7. If customization is needed, upload videos or images to show on the following screen types:

   • Home screen: Upload a background image or video for the terminal's home screen.
   • Idle screen: Upload a screensaver for when the terminal is inactive. If a shopper interacts with the screen, the terminal returns to the Home screen.

     This is only available for countertop, non-battery powered terminals, for example P630, SFO1, and M450.

   • After payment screen: Upload an image or video to be shown after a payment is completed.

     Showing content on this screen extends the total transaction time. If another payment request is received, the terminal bypasses this screen to immediately begin the next payment.

   • Shopper engagement screen: Add an image or video to show during a shopper engagement request. The image or video will appear on the screen together with the content from the API request.

     This is only available for terminals with larger screens, for example SFO1, M450.

8. Select Save.

9. If there are additional tabs for other terminal models, go to these tabs one-by-one and repeat the steps to check the previews, customize as needed, and save the changes.

You can now apply your themes to specific terminals. Otherwise, the terminals continue to use the Adyen theme with the Adyen logo.

Apply a theme

After creating a theme, you can apply your theme to your terminals at the company, merchant, store, or terminal level. If you do not select a theme to apply, the Adyen theme with the Adyen logo and dark mode applies.

1. Log in to your Customer Area.
2. Go to In-person payments > Terminal settings on the level where you want to apply the theme, such as company, merchant, store or terminal level, then select Customization.
3. Select the edit icon , and select either Adyen (for the default Adyen theme) or Custom (for one of the themes you created).
4. Select Save.

The changes take effect when the terminal downloads the configuration during its maintenance call to our system.

If WebSockets are enabled, changes apply to your terminal almost immediately. Optionally, you can update the configuration manually on the terminal.

Manage themes

You can manage your themes by modifying or deleting them at any time.

1. Log in to your Customer Area and if applicable, go to the company or merchant account where you created the theme.
2. Go to In-person payments > Themes.
3. To modify a theme, select a theme and make your changes, then select Save.
4. To delete a theme, select a theme you want to delete, select the option icon , then select Delete theme.

See also