Request the Tap to Pay on iPhone development entitlement from your Apple Developer account and add the com.apple.developer.proximity-reader.payment.acceptance entitlement (boolean true) to your app target.
Integrate Terminal iOS SDK v4 or later; v4 consolidates all reader connection methods into the unified connectReader API and renames the discovery method to SCPDiscoveryMethodTapToPay.
Create an SCPDiscoveryConfiguration using SCPDiscoveryMethodTapToPay and call discoverReaders; the SDK will surface the iPhone itself as the discovered reader.
Pass the discovered reader to connectReader along with an SCPTapToPayConnectionConfiguration that includes a locationId and an SCPTapToPayReaderDelegate.
Collect payment with collectPaymentMethod and confirm with confirmPaymentIntent; PIN entry is supported on devices running iOS 16.4 or later.
Known gotchas
The discovery method is SCPDiscoveryMethodTapToPay in SDK v4 — earlier SDK versions used SCPDiscoveryMethodLocalMobile; rename all references when migrating.
The unified connectReader method replaces the old connectLocalMobileReader method; passing an SCPTapToPayConnectionConfiguration to connectReader determines the connection type.
PIN entry requires iOS 16.4 or later; on earlier iOS versions the payment can still be collected but PIN-required transactions will be declined rather than prompting for PIN.
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