---
title: "Manage your iOS Mobile solution"
description: "Learn how to enable and maintain your solution and keep the software up-to-date."
url: "https://docs.adyen.com/point-of-sale/mobile-ios/manage"
source_url: "https://docs.adyen.com/point-of-sale/mobile-ios/manage.md"
canonical: "https://docs.adyen.com/point-of-sale/mobile-ios/manage"
last_modified: "2026-03-13T15:21:00+01:00"
language: "en"
---

# Manage your iOS Mobile solution

Learn how to enable and maintain your solution and keep the software up-to-date.

[View source](/point-of-sale/mobile-ios/manage.md)

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

Applies to:

Tap to Pay on iPhone.

Does not apply to:

Card reader on iOS.

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](/point-of-sale/mobile-ios/build/tap-to-pay#accept-terms).

If you are a platform with an [Adyen for Platforms](/adyen-for-platforms-model) 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:

1. In your [live Customer Area](https://ca-live.adyen.com/), go to **In-person payments** > **Tap to Pay & card reader**.
2. In the **Apple Tap to Pay Terms of Use** box, select **Accept Terms of Use**.
3. Next to your merchant account, check the **Status** to make sure the acceptance process has not started or completed yet.
4. 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.
5. 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.

## Enable accessibility mode for PIN transactions

Applies to:

Tap to Pay on iPhone.

Does not apply to:

Card reader on iOS.\
For shoppers with visual impairments, using a payment terminal can be challenging. Depending on your location, it can be a regulatory requirement to make your iPhone accessible to shoppers who are visually impaired. Accessibility mode for PIN transactions is a built-in iOS feature that must be enabled manually for each transaction where it is needed. To enable accessibility mode, on the PIN entry screen, select **Accessibility Options**.

When accessibility is enabled, the iPhone provides the shopper with audio instructions to guide them through the payment flow. You can find a list of these instructions in Apple's [Tap to Pay on iPhone FAQ](https://support.apple.com/en-gw/guide/apple-business-connect/abcb71e19fc3/web).

## Set the transaction screen text

Applies to:

Tap to Pay on iPhone.

Does not apply to:

Card reader on iOS.

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](https://www.apple.com/business/connect/).
* To change the text identifying your business, contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other). We can configure different texts for your company, merchant accounts, and stores.

## Keep the Mobile SDK up to date

Applies to:

Tap to Pay on iPhone and Card reader on iOS.

To make sure that you can continue making payments, you need to regularly update the Mobile SDK. SDK versions [expire](#sdk-expiry) after 6 months and are [removed](#sdk-removal) after 18 months.

Make sure to [stay informed about Mobile SDK version changes](#stay-informed) and [add the new version to your project](/point-of-sale/mobile-ios/build/tap-to-pay#add-sdk). You can find the expiry and removal dates of a specific iOS Mobile SDK version in the [release notes](/point-of-sale/firmware-release-notes/).

### SDK expiry

As part of our security policy, each version of the Mobile SDK expires 6 months after release. When a version expires:

* Card reader PIN transactions are blocked.
* Tap to Pay on iPhone and card reader transactions without PIN are still possible.

### SDK removal

12 months after a Mobile SDK version expires, the version is removed. When a version is removed:

* All transactions are blocked. The SDK cannot be used anymore.
* The version is removed from GitHub.

Make sure to update to a supported Mobile SDK version before your current version is removed.

### 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.

You can find the expiry date of a specific iOS Mobile SDK in the following ways:

* In your [Customer Area](https://ca-test.adyen.com/), go to **In-person payments** > **Tap to Pay & card reader** and select the **SDK & OS versions** tab.
* In your [Customer Area](https://ca-test.adyen.com/), go to **In-person payments** > **Payment devices**, and select the **Mobile devices** tab.
* Check the [release notes](/point-of-sale/firmware-release-notes) of that version.

Only iOS Mobile SDK versions 2.9.0 or later are visible in the Customer Area.

## Keep the device OS up to date

Applies to:

Tap to Pay on iPhone and Card reader on iOS.

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](/point-of-sale/mobile-ios/requirements/#software) and subscribe to [system messages](#stay-informed) about required OS updates.

You can find the OS version of your mobile devices in the following ways:

* In your [Customer Area](https://ca-test.adyen.com/), go to **In-person payments** > **Tap to Pay & card reader** and select the **SDK & OS versions** tab.
* In your [Customer Area](https://ca-test.adyen.com/), go to **In-person payments** > **Payment devices**, and select the **Mobile devices** tab.

### Reminders for Tap to Pay on iPhone

Applies to:

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](/point-of-sale/mobile-ios/security#mpoc-approval-ttp).

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

Applies to:

Card reader on iOS.

Does not apply to:

Tap to Pay on iPhone.

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](/point-of-sale/mobile-ios/understand/#updating-card-reader) 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

Applies to:

Card reader on iOS in combination with a USB dock.

Does not apply to:

Tap to Pay on iPhone.

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](/point-of-sale/mobile-ios/understand/#updating-usb-dock) 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

Applies to:

All iOS Mobile solutions.

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.

1. In your [Customer Area](https://ca-test.adyen.com/), in the top navigation bar, select the **Notification center icon** **.
2. Select **Settings**.
3. 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](/point-of-sale/firmware-release-notes/) for the expiry date of a specific SDK version .

## Change the language

Applies to:

All iOS Mobile solutions.

![](/user/themes/adyen/images/illustrations/warning.svg) The iOS Mobile SDK supports English, Dutch, and French. More languages will be added in future releases.

English is the language that the SDK uses by default for the transaction flow and the UI for card reader operations. To switch to a different language, you have the following options:

* In the system settings of the mobile device, select the other language as the highest priority language. This changes the system language of the device.

* If only your POS application should be shown in the other language, in the system settings go to the app language settings, select your POS app, and select the other language.

If you select a language that the SDK does not support, the SDK will use English.

### Change the receipt language

The default language of the shopper receipt and the merchant receipt is English. To switch to a different supported language for either or both receipts, contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other).

## See also

* [Go-live checklist](/point-of-sale/mobile-ios/checklists#go-live-checklist)
* [Release notes](/point-of-sale/firmware-release-notes)
* [UI for card reader operations](/point-of-sale/mobile-ios/understand#ui-for-card-reader-operations)
