{"title":"Deploy using profiles","category":"default","creationDate":1776961627,"content":"<p>Android profiles are a convenient way to set up an automatic installation of apps on your Android payment terminals. After you <a href=\"\/pt\/point-of-sale\/android-terminals\/deploy-apps\/upload\">upload<\/a> your apps to your Customer Area, you can add them to an Android profile and specify the conditions when the profile applies. Conditions you can use are <strong>stores<\/strong>, <strong>countries\/regions<\/strong>, and Android terminal <strong>models<\/strong>.<\/p>\n<p>For example, if you create a profile for S1E terminals in 12 of your stores in the US, and add two apps to the profile:<\/p>\n<ul>\n<li>The two apps are automatically installed on all S1E terminals in those stores.<\/li>\n<li>When a new S1E terminal is boarded in one of those stores, that terminal gets the two apps as well.<\/li>\n<li>If you later replace one of the apps in the profile with a new version, all terminals that the profile applies to automatically install the new app version.<\/li>\n<\/ul>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements.<\/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 <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api\">Terminal API<\/a> integration with payment terminals or a <a href=\"\/pt\/point-of-sale\/standalone\">standalone solution<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/account\/user-roles\">Customer Area roles<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">To manage profiles using the Customer Area, you must have the following role: <ul><li markdown=\"1\"><strong>Merchant POS Terminal Management Admin role<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Hardware<\/strong><\/td>\n<td style=\"text-align: left;\">Android payment terminals.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Use cases<\/h2>\n<p>Here are some situations when Android profiles are helpful:<\/p>\n<ul>\n<li>\n<p>Boarding a terminal to a store. The terminal automatically installs the apps from the profile that applies to the store. This is the case for:<\/p>\n<ul>\n<li>New terminals<\/li>\n<li>Replacement terminals<\/li>\n<li>\n<p>Terminal migrations<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Country profiles. For example, you define one profile for your stores in the US and another profile for your stores in the UK.<\/p>\n<\/li>\n<li>\n<p>Terminal usage: Depending on how terminals are used, you define profiles with different apps for different terminal models.<\/p>\n<\/li>\n<\/ul>\n<h2>When profiles take effect<\/h2>\n<p>Android profiles are part of the configuration of the terminal. Terminals receive their configuration when they are boarded, or when they make a <a href=\"\/pt\/point-of-sale\/managing-terminals\/maintain-performance\">maintenance call<\/a>.<\/p>\n<ul>\n<li>\n<p>If a terminal is not boarded yet, it will install the apps from the Android profile as soon as the terminal is boarded. This enables you, for example, to prepare for the opening of a new store.<\/p>\n<\/li>\n<li>\n<p>If a terminal is already boarded, it implements the Android profile immediately after the maintenance call. Apps are installed or uninstalled depending on the profile and any updates to the profile.<br \/>\nIf the profile updates an Android app that is already installed on the terminal and that happens to be open, the app closes.<\/p>\n<\/li>\n<\/ul>\n<p>If you deploy apps and certificates to a terminal <a href=\"\/pt\/point-of-sale\/android-terminals\/deploy-apps\/terminal-actions-api\">using API calls<\/a> or <a href=\"\/pt\/point-of-sale\/android-terminals\/deploy-apps\/schedule\">manually using the Customer Area<\/a>, that overwrites the apps that are installed on the terminal based on a profile.<\/p>\n<h2>Create a profile<\/h2>\n<p>Creating an Android profile is a two-step process:<\/p>\n<ul>\n<li>First you define the conditions when the profile should apply.<\/li>\n<li>Then you add the apps that the profile should install.<\/li>\n<\/ul>\n<p>If you are going to create multiple profiles, be aware that you cannot have two Android profiles with the same conditions.<\/p>\n<h3>1. Define conditions<\/h3>\n<ol>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> go to <strong>In-person payments<\/strong> &gt; <strong>Android<\/strong> and select the <strong>Profiles<\/strong> tab.<\/li>\n<li>Select <strong>Create profile<\/strong>.<\/li>\n<li>Enter the <strong>Name<\/strong> and <strong>Description<\/strong> for your profile.<\/li>\n<li>Select the conditions when the profile should apply:<br \/>\na. <strong>Select stores<\/strong>: this installs apps from the profile to all terminals assigned to the selected stores<br \/>\nb. <strong>Select countries\/regions<\/strong>: this installs apps from the profile to all terminals assigned to the selected countries\/regions<br \/>\nc. <strong>Select models<\/strong>: this installs apps from the profile only to the selected terminal models<br \/>\nd. <strong>Select merchants<\/strong>: this installs apps from the profile to all terminals under the selected merchant account\n<div class=\"notices green\">\n<p>If you do not specify any conditions, the profile applies to all terminals in your company account.<\/p>\n<\/div><\/li>\n<li>Select <strong>Save<\/strong>.<\/li>\n<\/ol>\n<h3>2. Add apps to your profile<\/h3>\n<ol>\n<li>Under <strong>In-person payments<\/strong> &gt; <strong>Android<\/strong> &gt; <strong>Profiles<\/strong>, select your profile.<\/li>\n<li>Select <strong>Add app<\/strong>.<\/li>\n<li>Under <strong>App name<\/strong>, select apps from the list of apps <a href=\"\/pt\/point-of-sale\/android-terminals\/deploy-apps\/upload#upload-your-app\">uploaded<\/a> to your company account.\n<div class=\"notices green\">\n<p>Only apps that have reached the <strong>Ready<\/strong> status show.<\/p>\n<\/div><\/li>\n<li>Under <strong>Version<\/strong>, select the app version from the drop-down list.<\/li>\n<li>In the dialog box, select <strong>Add app<\/strong>.<\/li>\n<\/ol>\n<p>The profile is applied as soon as terminals are boarded or make a maintenance call.<\/p>\n<p><\/li>\n<\/ol>\n<h2>Manage profiles<\/h2>\n<p>You can update all aspects of a profile.<\/p>\n<ol>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> go to <strong>In-person payments<\/strong> &gt; <strong>Android<\/strong> and select the <strong>Profiles<\/strong> tab.<\/li>\n<li>Select your profile.<\/li>\n<li>Make changes as needed:\n<ul>\n<li>To change the profile name, description, and conditions, select <strong>Edit<\/strong>.<\/li>\n<li>To update an app, select the <img alt=\"\" src=\"\/user\/pages\/docs\/03.point-of-sale\/50.android-terminals\/02.deploy-apps\/03.profiles\/3dots.png\" \/> icon for the app and select <strong>Edit app version<\/strong>.<\/li>\n<li>To delete an app, select the <img alt=\"\" src=\"\/user\/pages\/docs\/03.point-of-sale\/50.android-terminals\/02.deploy-apps\/03.profiles\/3dots.png\" \/> icon for the app and select <strong>Remove app<\/strong>.<\/li>\n<li>To add apps, select <strong>Add app<\/strong>.<\/li>\n<\/ul><\/li>\n<li>Select <strong>Save<\/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\/android-terminals\/app-requirements\"\n                        target=\"_self\"\n                        >\n                    Specifications and testing of apps for Android terminals\n                <\/a><\/li><li><a href=\"\/point-of-sale\/android-terminals\/deploy-apps\/upload\"\n                        target=\"_self\"\n                        >\n                    Upload apps and certificates\n                <\/a><\/li><li><a href=\"\/point-of-sale\/android-terminals\/deploy-apps\/terminal-actions-api\"\n                        target=\"_self\"\n                        >\n                    Manage app deployment using API requests\n                <\/a><\/li><li><a href=\"\/point-of-sale\/android-terminals\/deploy-apps\/schedule\"\n                        target=\"_self\"\n                        >\n                    Manage app deployment using the Customer Area\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/android-terminals\/deploy-apps\/profiles","articleFields":{"description":"Create Android profiles in your Customer Area to manage the deployment of apps to your Android terminals.","feedback_component":true},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/android-terminals\/deploy-apps\/profiles","title":"Deploy using profiles","content":"Android profiles are a convenient way to set up an automatic installation of apps on your Android payment terminals. After you upload your apps to your Customer Area, you can add them to an Android profile and specify the conditions when the profile applies. Conditions you can use are stores, countries\/regions, and Android terminal models.\nFor example, if you create a profile for S1E terminals in 12 of your stores in the US, and add two apps to the profile:\n\nThe two apps are automatically installed on all S1E terminals in those stores.\nWhen a new S1E terminal is boarded in one of those stores, that terminal gets the two apps as well.\nIf you later replace one of the apps in the profile with a new version, all terminals that the profile applies to automatically install the new app version.\n\nRequirements\nBefore you begin, take into account the following requirements.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nA Terminal API integration with payment terminals or a standalone solution.\n\n\nCustomer Area roles\nTo manage profiles using the Customer Area, you must have the following role: Merchant POS Terminal Management Admin role\n\n\nHardware\nAndroid payment terminals.\n\n\n\nUse cases\nHere are some situations when Android profiles are helpful:\n\n\nBoarding a terminal to a store. The terminal automatically installs the apps from the profile that applies to the store. This is the case for:\n\nNew terminals\nReplacement terminals\n\nTerminal migrations\n\n\n\n\n\nCountry profiles. For example, you define one profile for your stores in the US and another profile for your stores in the UK.\n\n\nTerminal usage: Depending on how terminals are used, you define profiles with different apps for different terminal models.\n\n\nWhen profiles take effect\nAndroid profiles are part of the configuration of the terminal. Terminals receive their configuration when they are boarded, or when they make a maintenance call.\n\n\nIf a terminal is not boarded yet, it will install the apps from the Android profile as soon as the terminal is boarded. This enables you, for example, to prepare for the opening of a new store.\n\n\nIf a terminal is already boarded, it implements the Android profile immediately after the maintenance call. Apps are installed or uninstalled depending on the profile and any updates to the profile.\nIf the profile updates an Android app that is already installed on the terminal and that happens to be open, the app closes.\n\n\nIf you deploy apps and certificates to a terminal using API calls or manually using the Customer Area, that overwrites the apps that are installed on the terminal based on a profile.\nCreate a profile\nCreating an Android profile is a two-step process:\n\nFirst you define the conditions when the profile should apply.\nThen you add the apps that the profile should install.\n\nIf you are going to create multiple profiles, be aware that you cannot have two Android profiles with the same conditions.\n1. Define conditions\n\nIn your Customer Area go to In-person payments &gt; Android and select the Profiles tab.\nSelect Create profile.\nEnter the Name and Description for your profile.\nSelect the conditions when the profile should apply:\na. Select stores: this installs apps from the profile to all terminals assigned to the selected stores\nb. Select countries\/regions: this installs apps from the profile to all terminals assigned to the selected countries\/regions\nc. Select models: this installs apps from the profile only to the selected terminal models\nd. Select merchants: this installs apps from the profile to all terminals under the selected merchant account\n\nIf you do not specify any conditions, the profile applies to all terminals in your company account.\n\nSelect Save.\n\n2. Add apps to your profile\n\nUnder In-person payments &gt; Android &gt; Profiles, select your profile.\nSelect Add app.\nUnder App name, select apps from the list of apps uploaded to your company account.\n\nOnly apps that have reached the Ready status show.\n\nUnder Version, select the app version from the drop-down list.\nIn the dialog box, select Add app.\n\nThe profile is applied as soon as terminals are boarded or make a maintenance call.\n\n\nManage profiles\nYou can update all aspects of a profile.\n\nIn your Customer Area go to In-person payments &gt; Android and select the Profiles tab.\nSelect your profile.\nMake changes as needed:\n\nTo change the profile name, description, and conditions, select Edit.\nTo update an app, select the  icon for the app and select Edit app version.\nTo delete an app, select the  icon for the app and select Remove app.\nTo add apps, select Add app.\n\nSelect Save.\n\nSee also\n\n\n                    Specifications and testing of apps for Android terminals\n                \n                    Upload apps and certificates\n                \n                    Manage app deployment using API requests\n                \n                    Manage app deployment using the Customer Area\n                \n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Android terminals","lvl3":"Deploy apps to your terminals","lvl4":"Deploy using profiles"},"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":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/android-terminals\/deploy-apps","lvl4":"\/pt\/point-of-sale\/android-terminals\/deploy-apps\/profiles"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Deploy","using","profiles"]},"articleFiles":{"3dots.png":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/50.android-terminals\/02.deploy-apps\/03.profiles\/3dots.png\" \/>"}}