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.
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:
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.
We recommend that you 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.