There are certain tasks that need to be done when going live with iOS Mobile solution, such as accepting Apple's Terms of Use. Then, when your solution is live and distributed to your users, you need to ensure that all required software updates are carried out. Otherwise there is a risk of temporarily not being able to continue transacting.
Accept Apple Terms of Use for Tap to Pay on iPhone
To make Tap to Pay transactions on an iPhone, the Apple Terms of Use for Tap to Pay on iPhone must be accepted.
In the test environment, the only way to accept the Apple Terms of Use is on the iPhone itself.
If you are a platform with an Adyen for Platforms integration, the same is true for the live environment. Your users are prompted on their iPhone to accept the Apple Terms of Use when they start the first live Tap to Pay on iPhone transaction on that phone.
If you are not a platform or marketplace and going live, you can use the live Customer Area to accept the Apple Terms of Use through your merchant account. This covers all iPhones that transact under the live merchant account. There will be no prompt to accept Apple's Terms of Use on those iPhones.
To accept the Apple Terms of Use through the Customer Area:
- In your live Customer Area, go to In-person payments > Tap to Pay & card reader.
- In the Apple Tap to Pay Terms of Use box, select Accept Terms of Use.
- Next to your merchant account, check the Status to make sure the acceptance process has not started or completed yet.
- Next to your merchant account, select Accept.
You are redirected to Apple Business Connect.
If the error message Apple link generation failed appears, try again. - In Apple Business Connect, log in with the Apple iCloud account of your business and complete the steps.
In the live Customer Area, the Status of the acceptance process is updated. However, Adyen does not know the outcome in all cases. When in doubt, check the status in Apple Business Connect.
Set the transaction screen text
During a Tap to Pay on iPhone payment, customers will see a screen including the payment amount, and an icon with a text line to identify your business. The icon is determined by default based on your Merchant Category Code (MCC). The text by default shows your Adyen merchant account name.
- You can manage and change the icon in Apple Business Connect.
- To change the text identifying your business, contact our Support Team. We can configure different texts for your company, merchant accounts, and stores.
Keep the Mobile SDK up to date
To make sure that you can continue making payments using your Mobile solution, you need to regularly update the Mobile SDK.
As part of our security policy, each version of the Mobile SDK expires six months after the version was released. When a version of the iOS Mobile SDK has expired, you can no longer make card reader PIN transactions with that version. Only Tap to Pay on iPhone and card reader transactions without PIN are possible.
Make sure to stay informed about Mobile SDK version changes and add the new version to your project .
You can find the expiry date of a specific iOS Mobile SDK version in the release notes of that version.
SDK support policy
The Mobile SDK follows semantic versioning MAJOR.MINOR.PATCH:
- MAJOR: a major version increment indicates incompatible changes.
- MINOR: a minor version increment indicates added functionality that is backwards compatible.
- PATCH: a patch version increment indicates backwards-compatible bug fixes.
We do not support bug fixes to earlier MINOR or PATCH SDK versions. If you find bugs in an older MINOR or PATCH version, we recommend to update to the latest available SDK.
Keep the device OS up to date
To make sure that you can continue making payments using your Mobile solution, you need to regularly update the iOS version on your mobile device.
If your mobile device is not running the minimum required iOS version, all Mobile SDK transactions will be blocked. Make sure to check the software requirements and subscribe to system messages about required OS updates.
Reminders for Tap to Pay on iPhone
For continued Tap to Pay on iPhone support, the iOS version must be updated within one year of the release date of the iOS version that is in use. See PCI approval of Tap to Pay on iPhone.
Users are informed as follows about the need to update the iOS version of their mobile device:
-
iOS 18.4 and later
The UI shows a reminder to update the iOS, with a link to go directly to Settings > Software Update on the device. The reminder appears once a week from 90 days before the deprecation date and then once a day from three days before the deprecation date. -
iOS 17.6 and later
When an iOS version has been deprecated, the UI shows both a notification to update to the latest iOS version and the following error:Error: This device's OS version is not supported
-
Earlier than iOS 17.6
The UI shows the following error:Error: This device's OS version is not supported
Keep the card reader up to date
The firmware of the card reader must be updated from time to time, to keep the reader secure.
You must check for new firmware updates regularly, and update your card readers to the latest version.
The Mobile SDK provides built-in screens to alert the user to firmware updates and to start the update. If you do not use the built-in UI, you must implement this functionality into your own custom UI.
Keep the dock up to date
The firmware of the dock must be updated from time to time, to keep the dock secure.
You must check for new 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. If you do not use the built-in UI, you must implement this functionality into your own custom UI.
Stay informed about version changes
To stay informed about version changes of the iOS Mobile SDK, the card reader, or the minimum required device OS, you need to subscribe to system messages.
- In your Customer Area, in the top navigation bar, select the Notification center icon .
- Select Settings.
- Under Developers and Integrations, on the rows for Mobile SDK releases and Mandatory updates select how you want to be informed: by Email and/or in the Notification center.
Also keep an eye on the release notes for the expiry date of a specific SDK version .