Tap to Pay on iPhone
Tap to Pay on iPhone (TTPOI) lets users accept in-person contactless payments with a compatible iPhone and the Stripe Terminal SDK. TTPOI includes support for Visa, Mastercard, American Express, and Discover contactless cards and NFC-based mobile wallets (Apple Pay, Google Pay, and Samsung Pay). TTPOI is included in the Terminal iOS SDK and enables payments directly in your iOS mobile app.
For platforms, use of Tap to Pay on iPhone is also subject to these Apple Acceptance Platform User Terms and Conditions. Platforms and merchants located outside the US are not permitted to use Tap to Pay on iPhone.
Get started
Tap to Pay on iPhone requires the latest version of the Terminal iOS SDK, and introduces a connectLocalMobileReader method and an SCPDiscoveryMethodLocalMobile discovery option.
You must first set up the Terminal iOS SDK. After you’re familiar with the iOS SDK, you can start supporting Tap to Pay on iPhone within your application.
Entitlements and build file
To use Tap to Pay on iPhone to accept payments, your application must request and configure the Tap to Pay on iPhone entitlement from your Apple Developer account. Instructions for requesting this entitlement can be found here.
After you add an entitlements file to your app build target, add the following:
| Key | com.apple.developer.proximity-reader.payment.acceptance |
| Value type | boolean |
| Value | true or 1 |
Supported devices
Tap to Pay on iPhone requires iPhone XS and later running iOS 16.0 and later. We recommend asking your users to update to the latest iOS version for the best experience.
Tap to Pay won’t work on beta releases of iOS.
Best practices and promotion guidelines
Please follow the Human Interface Guidelines for Tap to Pay on iPhone to ensure an optimal user experience and successful review process with Apple.
Consider the following:
- Connect to the reader in the background on app startup to reduce wait times when collecting a payment.
- Reconnect to the reader when the app comes to the foreground to reduce wait times.
- Provide merchant education to guide your users on how to accept contactless payments on a compatible iPhone, including in-product promotion and text or email alerts. See Apple’s developer marketing guidance and merchant education for more ideas.