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
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
Choose your iOS Mobile solution: Tap to Pay on iPhone or Card reader, or both.<\/p>\n
Take into account the countries\/regions, payment methods, and features that we support<\/a>, as well as the hardware and software requirements<\/a> for iOS.<\/p>\n<\/li>\n If you are new to Adyen, see Get started with Adyen<\/a> and set up your Adyen test account.<\/p>\n For details, see Set up your account for in-person payments<\/a>, and if applicable, see \"Account structure and resources\" for platforms<\/a> or for marketplaces<\/a>.<\/p>\n<\/li>\n Ask our Support Team<\/a> to configure your Adyen test account for using the iOS Mobile SDK.<\/p>\n<\/li>\n In your test Customer Area<\/a>:<\/p>\n If you decided for the card reader solution, order a test NYC1 card reader.<\/p>\n\n<\/li>\n<\/ul>\n<\/li>\n Ensure that you have a supported iOS mobile device that you can use for testing.<\/p>\n<\/li>\n Ensure that you have an iOS mobile POS app that is integrated with Terminal API<\/a>.<\/p>\n<\/li>\n Be aware that you need to manage additional dependencies related to expiry of the Mobile SDK and changes in the minimum required iOS version.<\/p>\n<\/li>\n Build your solution<\/a>.<\/p>\n 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 Tap to Pay on iPhone<\/a> or Card reader on iOS<\/a>.<\/p>\n<\/div>\n<\/li>\n Test your solution.<\/p>\n<\/li>\n<\/ol>\n If you are new to Adyen, apply for a live account.<\/p>\n<\/li>\n Ensure to apply for an Apple LIVE entitlement<\/a> for your Tap to Pay mobile solution in good time. The approval process can take up to several weeks.<\/p>\n<\/li>\n 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 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 Ask our Support Team<\/a> to configure your live account for using the iOS Mobile SDK.<\/p>\n<\/li>\n Ensure you know when the SDK, the iOS, and the card reader firmware (if applicable) must be updated:<\/p>\n Each SDK version expires after six months, and it is possible that the minimum required iOS version changes over time.<\/p>\n<\/div>\n Ensure that all your mobile devices are compliant with the hardware<\/a> and software<\/a> requirements and can be easily upgraded.<\/p>\n<\/li>\n When going live with your Tap to Pay on iPhone<\/a> or card reader<\/a> solution, update your API credentials and code:<\/p>\n Update your code to use the live API key and the live endpoint for establishing a communication session.<\/p>\n\n<\/li>\n<\/ol>\n<\/li>\n Optionally set a custom transaction screen text<\/a>.<\/p>\n<\/li>\n For Tap to Pay on iPhone, accept the Apple Terms of Use<\/a>.<\/p>\n<\/li>\n Test the live solution by doing penny tests.<\/p>\n<\/li>\n Ensure your personnel knows how to initiate transactions on the mobile device, how to handle error messages<\/a>, and if applicable how to use the NYC1 card reader<\/a>.<\/p>\n<\/li>\n<\/ol>\n 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 To add docks to your solution, take into account the following:<\/p>\n Orders<\/strong>: In your 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 Requirements<\/strong>: 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<\/a>. <\/p>\n<\/li>\n 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 built-in screens<\/a> for that. For instructions, see Use the built-in UI<\/a>. <\/p>\n If 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<\/a>. <\/p>\n<\/li>\n 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 built-in screens<\/a> to alert the user to firmware updates and to start the update. For instructions, see Use the built-in UI<\/a>. <\/p>\n If 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<\/a>. <\/p>\n<\/li>\n USB permissions<\/strong>: You must add a key for the dock to the End user instructions<\/strong>: We provide a guide with an overview of 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\n
Go-live checklist<\/h2>\n
\n
\n
\n
Checklist to add a dock<\/h2>\n
\n
\n
Info.plist<\/code> of your POS app. And if you are going to submit your app to the App Store, you must send us specific details about your app so that we can provide you with an MFi PPID. For instructions, see Manage USB permissions<\/a>. <\/p>\n<\/li>\nSee also<\/h2>\n