{"title":"Get-started and go-live checklists for Android","category":"default","creationDate":1776961627,"content":"<p>This page gives an overview of what needs to be done to be able to build and test a Mobile solution, and to be able to go live with a Mobile solution. There is also an overview of steps to take if you want to add docks to your card reader integration.<\/p>\n<div class=\"notices green\">\n<p>Our Mobile solutions are not a replacement for our traditional terminals. We are actively working towards use case and feature parity. Geographical availability may differ per solution.<\/p>\n<\/div>\n<h2>Get-started checklist<\/h2>\n<ol>\n<li>\n<p>Choose your Android Mobile solution: your own SDK-enabled app for Tap to Pay or Card reader (or both), or Tap to Pay through the Adyen Payments app.<\/p>\n<p>Take into account the countries\/regions, payment methods, and features that we <a href=\"\/pt\/point-of-sale\/ipp-mobile\">support<\/a>, as well as the <a href=\"\/pt\/point-of-sale\/mobile-android\/requirements\">hardware and software requirements<\/a> for Android.<\/p>\n<\/li>\n<li>\n<p>If you are new to Adyen, see <a href=\"\/pt\/get-started-with-adyen\/\">Get started with Adyen<\/a> and set up your Adyen test account.<\/p>\n<p>For details, see <a href=\"\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/\">Set up your account for in-person payments<\/a>, and if applicable, see \"Account structure and resources\" <a href=\"\/pt\/platforms\/account-structure-resources\/\">for platforms<\/a>.<\/p>\n<\/li>\n<li>\n<p>Ask 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 your Adyen test account for using our Mobile solutions.<\/p>\n<\/li>\n<li>\n<p>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">test Customer Area<\/a>:<\/p>\n<ul>\n<li>Order a test card, if you do not already have one.<\/li>\n<li>\n<p>If you decided for the card reader solution, order a test NYC1 card reader.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Ensure that you have a supported Android mobile device that you can use for testing.<\/p>\n<\/li>\n<li>\n<p>Ensure that you have an Android mobile POS app that is integrated with <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api\/\">Terminal API<\/a>.<\/p>\n<\/li>\n<li>\n<p>Be aware that you need to manage additional dependencies related to expiry of the Mobile SDK or the Payments app and changes in the minimum required Android version.<\/p>\n<\/li>\n<li>\n<p><a href=\"\/pt\/point-of-sale\/mobile-android\/build\">Build your solution<\/a>.<\/p>\n<div class=\"notices blue\">\n<p>If you are building an SDK integration, we recommend calling the warm-up function to ensure that the SDK is ready to take transactions. See <a href=\"\/pt\/point-of-sale\/mobile-android\/build\/tap-to-pay\/#use-warm-up\">Tap to Pay<\/a> or <a href=\"\/pt\/point-of-sale\/mobile-android\/build\/card-reader\/#use-warm-up\">Card reader<\/a>.<\/p>\n<\/div>\n<\/li>\n<li>\n<p>Test your solution.<\/p>\n<\/li>\n<\/ol>\n<h2>Go-live checklist<\/h2>\n<ol>\n<li>\n<p>If you are new to Adyen, apply for a live account.<\/p>\n<\/li>\n<li>\n<p>Get in touch with your Adyen contact to sign the contract addendum that specifies the terms and conditions for the use of Adyen Mobile solutions, and to set up pricing.<\/p>\n<\/li>\n<li>\n<p>If you use our card reader solution, inform Adyen about your rollout plan and the forecasted number of card readers and (if applicable) docks that you will need.<\/p>\n<\/li>\n<li>\n<p>Ask 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 configure your live account for using our Mobile solutions.<\/p>\n<\/li>\n<li>\n<p>Ensure you know when the Payment app or the SDK, the Android version, and the card reader firmware (if applicable) must be updated:<\/p>\n<div class=\"notices yellow\">\n<p>Each SDK version expires after six months, and it is possible that the minimum required OS version changes over time.<\/p>\n<\/div>\n<ol>\n<li>Ensure your organization has a process to distribute the software and to keep the software up to date. See <a href=\"\/pt\/point-of-sale\/mobile-android\/manage\">Manage your Android Mobile solution<\/a>.<\/li>\n<li>In your Customer Area, <a href=\"\/pt\/point-of-sale\/mobile-android\/manage\/#stay-informed\">subscribe to system messages<\/a> to receive email alerts about mandatory updates like changes in the minimum required Android version, Android payments app and SDK, and card reader releases.<\/li>\n<li>Keep up-to-date with changes in our <a href=\"\/pt\/point-of-sale\/firmware-release-notes\/\">Release notes<\/a>.<\/li>\n<li>Implement the <a href=\"\/pt\/point-of-sale\/diagnostics\/request-diagnosis\/#diagnosis-request-mobile\">diagnosis request<\/a> so that you can check each device for the expiry date of the installed SDK.<\/li>\n<li>If you are using our card reader solution, implement the relevant Device Manager function to alert users to available firmware updates.<\/li>\n<\/ol>\n<\/li>\n<li>\n<p>Ensure that all your mobile devices are compliant with the <a href=\"\/pt\/point-of-sale\/mobile-android\/requirements\/#hardware\">hardware<\/a> and <a href=\"\/pt\/point-of-sale\/mobile-android\/requirements\/#software\">software<\/a> requirements and can be easily upgraded.<\/p>\n<\/li>\n<li>\n<p>Update your API credentials and code.<\/p>\n<p>Select the tab that matches your solution:<\/p>\n\n<div id=\"tabBpF5v\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;SDK added to your POS app&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When going live with your &lt;a href=\\&quot;\\\/pt\\\/point-of-sale\\\/mobile-android\\\/build\\\/tap-to-pay#go-live\\&quot;&gt;Tap to Pay&lt;\\\/a&gt; or &lt;a href=\\&quot;\\\/pt\\\/point-of-sale\\\/mobile-android\\\/build\\\/card-reader#go-live\\&quot;&gt;card reader&lt;\\\/a&gt; solution, update your API credentials and code:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your &lt;a href=\\&quot;https:\\\/\\\/ca-live.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;live Customer Area&lt;\\\/a&gt;, generate a live API credential with only the &lt;strong&gt;Allow SDK download for POS developers&lt;\\\/strong&gt; role.&lt;\\\/li&gt;\\n&lt;li&gt;Update your code to pull in the live version of the SDK.&lt;\\\/li&gt;\\n&lt;li&gt;In your &lt;a href=\\&quot;https:\\\/\\\/ca-live.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;live Customer Area&lt;\\\/a&gt;, generate a live API credential with an API key, a client key, and the &lt;strong&gt;Checkout webservice&lt;\\\/strong&gt; role.&lt;\\\/li&gt;\\n&lt;li&gt;Update your code to use the live API key and the live endpoint for establishing a communication session.&lt;\\\/li&gt;\\n&lt;li&gt;Optional. &lt;a href=\\&quot;\\\/pt\\\/point-of-sale\\\/mobile-android\\\/manage#google-play\\&quot;&gt;Upload your app to Google Play&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;\\\/pt\\\/point-of-sale\\\/mobile-android\\\/manage#register-app\\&quot;&gt;Register your app with Adyen&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;sdk_added_to_your_pos_app_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Android Payments app&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When &lt;a href=\\&quot;\\\/pt\\\/point-of-sale\\\/mobile-android\\\/build\\\/payments-app#go-live\\&quot;&gt;going live with the Android Payments app&lt;\\\/a&gt;, update your API credentials and code:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your &lt;a href=\\&quot;https:\\\/\\\/ca-live.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;live Customer Area&lt;\\\/a&gt;, generate a live API credential with only the &lt;strong&gt;Allow SDK download for POS developers&lt;\\\/strong&gt; role.&lt;\\\/li&gt;\\n&lt;li&gt;Download the Adyen Payments app from Google Play.&lt;\\\/li&gt;\\n&lt;li&gt;Update your code to use the live URLs for App Links.&lt;\\\/li&gt;\\n&lt;li&gt;Update your code to use the live base URL for Management API.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;android_payments_app_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<\/li>\n<li>\n<p>Test the live solution by doing penny tests.<\/p>\n<\/li>\n<li>\n<p>Ensure your personnel knows how to initiate transactions on the mobile device, how to <a href=\"\/pt\/point-of-sale\/mobile-android\/troubleshooting\">handle error messages<\/a>, and if applicable how to use the <a href=\"\/pt\/point-of-sale\/user-manuals\/nyc1\/\">NYC1 card reader<\/a> with or without an <a href=\"\/pt\/point-of-sale\/user-manuals\/nyc1-with-dock\/\">NYC1 dock<\/a>.<\/p>\n<\/li>\n<\/ol>\n<h2>Checklist to add a dock<\/h2>\n<p>If you decided to use the NYC1 card reader in your Mobile solution, you can add the NYC1 dock. The dock provides a way to:<\/p>\n<ul>\n<li>Charge the card reader.<\/li>\n<li>Charge the mobile device, if that is connected to the dock with a USB-C cable.<\/li>\n<li>Optionally establish a USB connection instead of a Bluetooth connection between your mobile device and the card reader.<\/li>\n<li>Create a countertop arrangement.<\/li>\n<\/ul>\n<p>To add docks to your solution, take into account the following:<\/p>\n<ol>\n<li>\n<p><strong>Orders<\/strong>: In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, order both the NYC1 dock and a 12V\/1.5A Power Delivery (PD) power adapter for the dock. The power adapter is not supplied with the dock because the adapter is region-specific. You can only use the NYC1 dock with the NYC1 power adapter from Adyen.<\/p>\n<\/li>\n<li>\n<p><strong>Requirements<\/strong>: Ensure you meet the system and hardware requirements to use the dock. The dock is supported from a specific <a href=\"\/pt\/point-of-sale\/mobile-android\/requirements#dock\">SDK version and card reader firmware version<\/a>. <\/p>\n<\/li>\n<li>\n<p><strong>Connecting to the dock<\/strong>: Your POS app needs to show if the card reader is placed in the dock and if the mobile device is connected to the card reader through Bluetooth or USB. The Mobile SDK provides <a href=\"\/pt\/point-of-sale\/mobile-android\/understand\/#connecting-usb-dock\">built-in screens<\/a> for that. For instructions, see <a href=\"\/pt\/point-of-sale\/mobile-android\/build\/card-reader?tab=use_the_built-in_ui_0_1\">Use the built-in UI<\/a>. <\/p>\n<p>If you do not use the built-in UI, you must implement this functionality into your own custom UI. For instructions, see <a href=\"\/pt\/point-of-sale\/mobile-android\/build\/card-reader?tab=build_a_custom_ui_1_2#connecting-usb-dock\">Build a custom UI - Connecting to the dock<\/a>. <\/p>\n<\/li>\n<li>\n<p><strong>Dock firmware<\/strong>: To keep the dock secure, you must check for new dock firmware updates regularly, and update your docks to the latest version. The Mobile SDK provides <a href=\"\/pt\/point-of-sale\/mobile-android\/understand\/#updating-usb-dock\">built-in screens<\/a>  to alert the user to firmware updates and to start the update. For instructions, see <a href=\"\/pt\/point-of-sale\/mobile-android\/build\/card-reader?tab=use_the_built-in_ui_0_1\">Use the built-in UI<\/a>. <\/p>\n<p>If you do not use the built-in UI, you must implement this functionality into your own custom UI. For instructions, see <a href=\"\/pt\/point-of-sale\/mobile-android\/build\/card-reader?tab=build_a_custom_ui_1_2#updating-usb-dock\">Build a custom UI - Updating the dock firmware<\/a>.  <\/p>\n<\/li>\n<li>\n<p><strong>End user instructions<\/strong>: We provide a guide with an overview of <a href=\"\/pt\/point-of-sale\/user-manuals\/nyc1-with-dock\">how to use the NYC1 card reader in combination with the NYC1 dock<\/a>. You can utilize this, for example, to instruct your store staff.<\/p>\n<\/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\/mobile-android\/build\"\n                        target=\"_self\"\n                        >\n                    Build your Android mobile solution\n                <\/a><\/li><li><a href=\"\/point-of-sale\/mobile-android\/manage\"\n                        target=\"_self\"\n                        >\n                    Keeping the SDK and card reader up to date\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/mobile-android\/checklists","articleFields":{"description":"Get ready for building and testing your Android Mobile solution and going live.","parameters":{"generic_sdk_name":"Mobile SDK","specific_sdk_name":"Mobile SDK for Android","platform":"Android"},"type":"page","feedback_component":true,"filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/mobile-android\/checklists","title":"Get-started and go-live checklists for Android","content":"This page gives an overview of what needs to be done to be able to build and test a Mobile solution, and to be able to go live with a Mobile solution. There is also an overview of steps to take if you want to add docks to your card reader integration.\n\nOur Mobile solutions are not a replacement for our traditional terminals. We are actively working towards use case and feature parity. Geographical availability may differ per solution.\n\nGet-started checklist\n\n\nChoose your Android Mobile solution: your own SDK-enabled app for Tap to Pay or Card reader (or both), or Tap to Pay through the Adyen Payments app.\nTake into account the countries\/regions, payment methods, and features that we support, as well as the hardware and software requirements for Android.\n\n\nIf you are new to Adyen, see Get started with Adyen and set up your Adyen test account.\nFor details, see Set up your account for in-person payments, and if applicable, see \"Account structure and resources\" for platforms.\n\n\nAsk our Support Team to enable your Adyen test account for using our Mobile solutions.\n\n\nIn your test Customer Area:\n\nOrder a test card, if you do not already have one.\n\nIf you decided for the card reader solution, order a test NYC1 card reader.\n\n\n\n\n\nEnsure that you have a supported Android mobile device that you can use for testing.\n\n\nEnsure that you have an Android mobile POS app that is integrated with Terminal API.\n\n\nBe aware that you need to manage additional dependencies related to expiry of the Mobile SDK or the Payments app and changes in the minimum required Android version.\n\n\nBuild your solution.\n\nIf you are building an SDK integration, we recommend calling the warm-up function to ensure that the SDK is ready to take transactions. See Tap to Pay or Card reader.\n\n\n\nTest your solution.\n\n\nGo-live checklist\n\n\nIf you are new to Adyen, apply for a live account.\n\n\nGet in touch with your Adyen contact to sign the contract addendum that specifies the terms and conditions for the use of Adyen Mobile solutions, and to set up pricing.\n\n\nIf you use our card reader solution, inform Adyen about your rollout plan and the forecasted number of card readers and (if applicable) docks that you will need.\n\n\nAsk our Support Team to configure your live account for using our Mobile solutions.\n\n\nEnsure you know when the Payment app or the SDK, the Android version, and the card reader firmware (if applicable) must be updated:\n\nEach SDK version expires after six months, and it is possible that the minimum required OS version changes over time.\n\n\nEnsure your organization has a process to distribute the software and to keep the software up to date. See Manage your Android Mobile solution.\nIn your Customer Area, subscribe to system messages to receive email alerts about mandatory updates like changes in the minimum required Android version, Android payments app and SDK, and card reader releases.\nKeep up-to-date with changes in our Release notes.\nImplement the diagnosis request so that you can check each device for the expiry date of the installed SDK.\nIf you are using our card reader solution, implement the relevant Device Manager function to alert users to available firmware updates.\n\n\n\nEnsure that all your mobile devices are compliant with the hardware and software requirements and can be easily upgraded.\n\n\nUpdate your API credentials and code.\nSelect the tab that matches your solution:\n\n\n    \n        \n        \n    \n\n\n\n\nTest the live solution by doing penny tests.\n\n\nEnsure your personnel knows how to initiate transactions on the mobile device, how to handle error messages, and if applicable how to use the NYC1 card reader with or without an NYC1 dock.\n\n\nChecklist to add a dock\nIf you decided to use the NYC1 card reader in your Mobile solution, you can add the NYC1 dock. The dock provides a way to:\n\nCharge the card reader.\nCharge the mobile device, if that is connected to the dock with a USB-C cable.\nOptionally establish a USB connection instead of a Bluetooth connection between your mobile device and the card reader.\nCreate a countertop arrangement.\n\nTo add docks to your solution, take into account the following:\n\n\nOrders: In your Customer Area, order both the NYC1 dock and a 12V\/1.5A Power Delivery (PD) power adapter for the dock. The power adapter is not supplied with the dock because the adapter is region-specific. You can only use the NYC1 dock with the NYC1 power adapter from Adyen.\n\n\nRequirements: Ensure you meet the system and hardware requirements to use the dock. The dock is supported from a specific SDK version and card reader firmware version. \n\n\nConnecting to the dock: Your POS app needs to show if the card reader is placed in the dock and if the mobile device is connected to the card reader through Bluetooth or USB. The Mobile SDK provides built-in screens for that. For instructions, see Use the built-in UI. \nIf you do not use the built-in UI, you must implement this functionality into your own custom UI. For instructions, see Build a custom UI - Connecting to the dock. \n\n\nDock firmware: To keep the dock secure, you must check for new dock firmware updates regularly, and update your docks to the latest version. The Mobile SDK provides built-in screens  to alert the user to firmware updates and to start the update. For instructions, see Use the built-in UI. \nIf you do not use the built-in UI, you must implement this functionality into your own custom UI. For instructions, see Build a custom UI - Updating the dock firmware.  \n\n\nEnd user instructions: We provide a guide with an overview of how to use the NYC1 card reader in combination with the NYC1 dock. You can utilize this, for example, to instruct your store staff.\n\n\nSee also\n\n\n                    Build your Android mobile solution\n                \n                    Keeping the SDK and card reader up to date\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Android Mobile solutions","lvl3":"Get-started and go-live checklists for Android"},"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\/mobile-android","lvl3":"\/pt\/point-of-sale\/mobile-android\/checklists"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Get-started","go-live","checklists","Android"]}}
