Apply for the Apple Tap to Pay entitlement separately for test and live environments via Apple's developer portal; configure the entitlement in your Xcode project.
Add the Adyen iOS Mobile SDK via Swift Package Manager using basic authentication credentials from your Adyen Customer Area; Xcode 16 or later is required for development, and the minimum device iOS version is 17.0.
Implement the `AuthenticationProvider` protocol to supply a fresh SDK authentication token obtained from Adyen's server-to-server configuration API endpoint.
Integrate with the Terminal API: initialize a communication session server-side, then call the SDK to start a Tap to Pay payment session and present the tap prompt on the iPhone screen.
Handle payment results and errors from the SDK callback; surface `ADY`-prefixed error types to your UI (Objective-C compatibility requires the `ADY` prefix on public symbols).
Keep the SDK current: the iOS Mobile SDK also expires every six months; monitor Adyen release notes and update before expiry to avoid disruptions.
Known gotchas
Adyen iOS Mobile SDK requires iOS 17.0 as the minimum device OS; Xcode 16 or later is required to build. Do not apply Stripe's or Square's iOS version floor to this integration.
Both test and live Apple Tap to Pay entitlements must be requested from Apple separately; using a test entitlement in a live build will result in payment failures.
The iOS SDK expires every six months after release, the same as the Android SDK; plan regular SDK updates to avoid payment outages.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp