{"title":"Activate barcode scanning using the scan button on the terminal","category":"default","creationDate":1672052400,"content":"<p>On Android payment terminals <a href=\"\/pt\/point-of-sale\/user-manuals\/s1e-user-manual\">S1E Barcode<\/a>, <a href=\"\/pt\/point-of-sale\/user-manuals\/s1e2l-user-manual\">S1E2L<\/a>, <a href=\"\/pt\/point-of-sale\/user-manuals\/s1f2-user-manual\">S1F2L<\/a>, and <a href=\"\/pt\/point-of-sale\/user-manuals\/s1u2-user-manual\">S1U2<\/a> you can make use of the barcode scanner button. When this feature is enabled in your Customer Area, you press the button to activate the scanner. If it scans a barcode, the terminal pastes the barcode content into an Android app with an input box installed on the terminal. You can also enable the software keyboard feature where the terminal simulates typing the barcode content as individual characters. For this to work, your app needs to listen for software keyboard events.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/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\/get-started\">Terminal API integration<\/a> with payment terminals or a <a href=\"\/pt\/point-of-sale\/standalone\">Standalone &lt;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 enable the barcode scanner button on the terminal, you need the following <a href=\"\/pt\/account\/user-roles\/#pos\">roles<\/a>: <br\/> <ul><li markdown=\"1\"><strong>Merchant POS Terminal Management Admin<\/strong> for configurations at any level.<\/li> <li markdown=\"1\"><strong>Merchant POS Terminal Management<\/strong> for configurations at merchant level (and lower).<\/ul><\/li><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Hardware<\/strong><\/td>\n<td style=\"text-align: left;\">Android payment terminal models <a href=\"\/pt\/point-of-sale\/user-manuals\/s1e-user-manual\">S1E Barcode<\/a>, <a href=\"\/pt\/point-of-sale\/user-manuals\/s1e2l-user-manual\">S1E2L<\/a>, <a href=\"\/pt\/point-of-sale\/user-manuals\/s1f2-user-manual\">S1F2L<\/a>, or <a href=\"\/pt\/point-of-sale\/user-manuals\/s1u2-user-manual\">S1U2<\/a> that have a barcode scanner.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">To process the scanned content, you need to have an Android barcode scanner app with an input text field installed on the terminal.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Enable button activation<\/h2>\n<p>You can enable barcode scanning per company, merchant accounts, store or terminal level:<\/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>Terminal Settings<\/strong> &gt; <strong>Hardware<\/strong> &gt; <strong>Barcode scanner<\/strong>.<\/li>\n<li>Under <strong>Enable barcode scanner button<\/strong>, select <strong>Enabled<\/strong>.<\/li>\n<li>To play a sound after a successful scan, under <strong>Play a beep<\/strong> select <strong>Enabled<\/strong>.<\/li>\n<li>To place a separator after each scan, under <strong>Separator<\/strong>  choose one of the following options:\n<ul>\n<li><strong>New line<\/strong>: passes the content of each scanned barcode in a new line. This option is set by default.<\/li>\n<li><strong>Custom<\/strong>: in the <strong>Custom character<\/strong> field, specify the character that you want to use as a separator.<\/li>\n<\/ul><\/li>\n<li>Select <strong>Save<\/strong>.<\/li>\n<\/ol>\n<p>Additionally, you can contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to enable:<\/p>\n<ul>\n<li>Adding a <strong>prefix<\/strong> to scanned barcodes. You need to provide the characters you want added in front of every scanned barcode content.<\/li>\n<li><strong>Software keyboard feature<\/strong>, where the barcode content is typed into your Android app as individual keyboard events. With this integration, your app needs to listen for software keyboard events.<\/li>\n<\/ul>\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\/scan-barcode\/batch-session\"\n                        target=\"_self\"\n                        >\n                    Multiple barcode scans with Terminal API\n                <\/a><\/li><li><a href=\"\/point-of-sale\/android-terminals\/scan-barcode\/single-session\"\n                        target=\"_self\"\n                        >\n                    Single barcode scan with Terminal API\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/android-terminals\/scan-barcode\/button-scan","articleFields":{"description":"Use the barcode scanning button on the terminal to activate the scanner.","feedback_component":true,"last_edit_on":"06-02-2025 16:35","page_id":"262d2cc2-e6a0-423d-9b82-e26684d36683","filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/android-terminals\/scan-barcode\/button-scan","title":"Activate barcode scanning using the scan button on the terminal","content":"On Android payment terminals S1E Barcode, S1E2L, S1F2L, and S1U2 you can make use of the barcode scanner button. When this feature is enabled in your Customer Area, you press the button to activate the scanner. If it scans a barcode, the terminal pastes the barcode content into an Android app with an input box installed on the terminal. You can also enable the software keyboard feature where the terminal simulates typing the barcode content as individual characters. For this to work, your app needs to listen for software keyboard events.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nA Terminal API integration with payment terminals or a Standalone &lt;solution.\n\n\nCustomer Area roles\nTo enable the barcode scanner button on the terminal, you need the following roles:  Merchant POS Terminal Management Admin for configurations at any level. Merchant POS Terminal Management for configurations at merchant level (and lower).\n\n\nHardware\nAndroid payment terminal models S1E Barcode, S1E2L, S1F2L, or S1U2 that have a barcode scanner.\n\n\nLimitations\nTo process the scanned content, you need to have an Android barcode scanner app with an input text field installed on the terminal.\n\n\n\nEnable button activation\nYou can enable barcode scanning per company, merchant accounts, store or terminal level:\n\nLog in to your Customer Area.\nGo to Terminal Settings &gt; Hardware &gt; Barcode scanner.\nUnder Enable barcode scanner button, select Enabled.\nTo play a sound after a successful scan, under Play a beep select Enabled.\nTo place a separator after each scan, under Separator  choose one of the following options:\n\nNew line: passes the content of each scanned barcode in a new line. This option is set by default.\nCustom: in the Custom character field, specify the character that you want to use as a separator.\n\nSelect Save.\n\nAdditionally, you can contact our Support Team to enable:\n\nAdding a prefix to scanned barcodes. You need to provide the characters you want added in front of every scanned barcode content.\nSoftware keyboard feature, where the barcode content is typed into your Android app as individual keyboard events. With this integration, your app needs to listen for software keyboard events.\n\nSee also\n\n\n                    Multiple barcode scans with Terminal API\n                \n                    Single barcode scan with Terminal API\n                \n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Android terminals","lvl3":"Barcode scanning","lvl4":"Activate barcode scanning using the scan button on the terminal"},"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\/scan-barcode","lvl4":"\/pt\/point-of-sale\/android-terminals\/scan-barcode\/button-scan"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Activate","barcode","scanning","using","button","terminal"]}}
