{"title":"Customize your Android payment terminals with themes","category":"default","creationDate":1776961627,"content":"<p>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.<\/p>\n<p>If you do not create and apply your own theme, the Adyen theme and dark mode is used.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements and limitations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\"><a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/\">Terminal API<\/a> integration or <a href=\"\/pt\/point-of-sale\/standalone\">standalone<\/a> solution.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Hardware<\/strong><\/td>\n<td style=\"text-align: left;\">All Android payment terminals on software version 1.120 or later.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li markdown=\"1\">Theme customization is only available for the new UI introduced in terminal software version v1.120. <li markdown=\"1\">For images or videos the following applies: <ul><li markdown=\"1\">Supported file types: JPG, PNG, MP4, or MOV.<\/li> <li markdown=\"1\">Max. file size: 100 MB<\/li> <li markdown=\"1\">Max. video resolution: 1280 x 800 or 574 x 634 (for shopper engagement screens).<\/li><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How it works<\/h2>\n<p>When you have your image or video files available that match the requirements:<\/p>\n<ol>\n<li>You create your theme in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> at the company or merchant account level:\n<ol>\n<li>You define the general settings for your theme by selecting dark or light mode.<\/li>\n<li>You check the preview for each of your terminal models, and optionally upload different or additional images or videos for the various models.<\/li>\n<\/ol><\/li>\n<li>You apply the theme at the desired level in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>: company or merchant account, store, or individual terminal.<\/li>\n<\/ol>\n<h2>Create a theme<\/h2>\n<p>To create a general theme in your Customer Area:<\/p>\n<ol>\n<li>\n<p>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> and make sure you have selected the company or merchant account that you want to create a theme for.<\/p>\n<\/li>\n<li>\n<p>Go to <strong>In-person payments<\/strong> &gt; <strong>Themes<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Select <strong>Create theme<\/strong>.<\/p>\n<\/li>\n<li>\n<p>On the tab for the <strong>General<\/strong> appearance:<\/p>\n<ol>\n<li>Give your theme a name,<\/li>\n<li>Select a <strong>Light<\/strong> or <strong>Dark mode<\/strong> for the <strong>Appearance<\/strong>.<\/li>\n<\/ol>\n<\/li>\n<li>\n<p>Select <strong>Save<\/strong>.<br \/>\nYou have now defined general settings for your theme.<\/p>\n<\/li>\n<li>\n<p>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.<\/p>\n<\/li>\n<li>\n<p>If customization is needed, upload videos or images to show on the following screen types:<\/p>\n<ul>\n<li><strong>Home screen:<\/strong> Upload a background image or video for the terminal's home screen.<\/li>\n<li><strong>Idle screen:<\/strong> Upload a screensaver for when the terminal is inactive. If a shopper interacts with the screen, the terminal returns to the <strong>Home screen<\/strong>.\n<div class=\"notices blue\">\n<p>This is only available for countertop, non-battery powered terminals, for example P630, SFO1, and M450.<\/p>\n<\/div><\/li>\n<li><strong>After payment screen:<\/strong> Upload an image or video to be shown after a payment is completed.\n<div class=\"notices yellow\">\n<p>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.<\/p>\n<\/div><\/li>\n<li><strong>Shopper engagement screen:<\/strong> Add an image or video to show during a <a href=\"\/pt\/point-of-sale\/shopper-engagement\/\">shopper engagement<\/a> request. The image or video will appear on the screen together with the content from the API request.\n<div class=\"notices blue\">\n<p>This is only available for terminals with larger screens, for example SFO1, M450.<\/p>\n<\/div><\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Select <strong>Save<\/strong>.<\/p>\n<\/li>\n<li>\n<p>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.<\/p>\n<\/li>\n<\/ol>\n<p>You can now apply your themes to specific terminals. Otherwise, the terminals continue to use the Adyen theme.<\/p>\n<h2>Apply a theme<\/h2>\n<p>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 and dark mode applies.<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Go to <strong>In-person payments<\/strong> &gt; <strong>Terminal settings<\/strong> on the level where you want to apply the theme, such as company, merchant, store or terminal level, then select <strong>Customization<\/strong>.<\/li>\n<li>Select the edit icon <i class=\"adl-icon-edit\"><\/i>, and select either <strong>Adyen<\/strong> (for the default Adyen theme) or <strong>Custom<\/strong> (for one of the themes you created).<\/li>\n<li>Select <strong>Save<\/strong>.<\/li>\n<\/ol>\n<p>The changes take effect when the terminal downloads the configuration during its maintenance call to our system.<\/p>\n<p>If <a href=\"\/pt\/point-of-sale\/diagnostics\/check-cloud-connection\/\">WebSockets<\/a> are enabled, changes apply to your terminal almost immediately. Optionally, you can <a href=\"\/pt\/point-of-sale\/managing-terminals\/maintain-performance\/#update-the-configuration-manually\">update the configuration manually<\/a> on the terminal.<\/p>\n<h2>Manage themes<\/h2>\n<p>You can manage your themes by modifying or deleting them at any time.<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> and if applicable, go to the company or merchant account where you created the theme.<\/li>\n<li>Go to <strong>In-person payments<\/strong> &gt; <strong>Themes<\/strong>.<\/li>\n<li>To modify a theme, select a theme and make your changes, then select <strong>Save<\/strong>.<\/li>\n<li>To delete a theme, select a theme you want to delete, select the option icon <strong><i class=\"adl-icon-options\"><\/i><\/strong>, then select <strong>Delete theme<\/strong>.<\/li>\n<\/ol>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/design-your-integration\/determine-account-structure\/configure-features#terminal-customization-hardware-features-and-receipts\"\n                        target=\"_self\"\n                        >\n                    Terminal customization, hardware features, and receipts\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/android-terminals\/themes","articleFields":{"description":"Create and manage themes that show during the payment flow on Android payment terminals.","page_id":"2b0a7ca9-a3f1-4241-bc09-031c8a3c8e6f","feedback_component":true,"filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/android-terminals\/themes","title":"Customize your Android payment terminals with themes","content":"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.\nIf you do not create and apply your own theme, the Adyen theme and dark mode is used.\nRequirements\nBefore you begin, take into account the following requirements and limitations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nTerminal API integration or standalone solution.\n\n\nHardware\nAll Android payment terminals on software version 1.120 or later.\n\n\nLimitations\nTheme customization is only available for the new UI introduced in terminal software version v1.120. For images or videos the following applies: Supported file types: JPG, PNG, MP4, or MOV. Max. file size: 100 MB Max. video resolution: 1280 x 800 or 574 x 634 (for shopper engagement screens).\n\n\n\nHow it works\nWhen you have your image or video files available that match the requirements:\n\nYou create your theme in your Customer Area at the company or merchant account level:\n\nYou define the general settings for your theme by selecting dark or light mode.\nYou check the preview for each of your terminal models, and optionally upload different or additional images or videos for the various models.\n\nYou apply the theme at the desired level in your Customer Area: company or merchant account, store, or individual terminal.\n\nCreate a theme\nTo create a general theme in your Customer Area:\n\n\nLog in to your Customer Area and make sure you have selected the company or merchant account that you want to create a theme for.\n\n\nGo to In-person payments &gt; Themes.\n\n\nSelect Create theme.\n\n\nOn the tab for the General appearance:\n\nGive your theme a name,\nSelect a Light or Dark mode for the Appearance.\n\n\n\nSelect Save.\nYou have now defined general settings for your theme.\n\n\nGo 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.\n\n\nIf customization is needed, upload videos or images to show on the following screen types:\n\nHome screen: Upload a background image or video for the terminal's home screen.\nIdle screen: Upload a screensaver for when the terminal is inactive. If a shopper interacts with the screen, the terminal returns to the Home screen.\n\nThis is only available for countertop, non-battery powered terminals, for example P630, SFO1, and M450.\n\nAfter payment screen: Upload an image or video to be shown after a payment is completed.\n\nShowing 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.\n\nShopper 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.\n\nThis is only available for terminals with larger screens, for example SFO1, M450.\n\n\n\n\nSelect Save.\n\n\nIf 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.\n\n\nYou can now apply your themes to specific terminals. Otherwise, the terminals continue to use the Adyen theme.\nApply a theme\nAfter 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 and dark mode applies.\n\nLog in to your Customer Area.\nGo to In-person payments &gt; Terminal settings on the level where you want to apply the theme, such as company, merchant, store or terminal level, then select Customization.\nSelect the edit icon , and select either Adyen (for the default Adyen theme) or Custom (for one of the themes you created).\nSelect Save.\n\nThe changes take effect when the terminal downloads the configuration during its maintenance call to our system.\nIf WebSockets are enabled, changes apply to your terminal almost immediately. Optionally, you can update the configuration manually on the terminal.\nManage themes\nYou can manage your themes by modifying or deleting them at any time.\n\nLog in to your Customer Area and if applicable, go to the company or merchant account where you created the theme.\nGo to In-person payments &gt; Themes.\nTo modify a theme, select a theme and make your changes, then select Save.\nTo delete a theme, select a theme you want to delete, select the option icon , then select Delete theme.\n\nSee also\n\n\n                    Terminal customization, hardware features, and receipts\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Android terminals","lvl3":"Customize your Android payment terminals with themes"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/android-terminals","lvl3":"\/pt\/point-of-sale\/android-terminals\/themes"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Customize","Android","payment","terminals","themes"]}}