调至内容部分
创建账户或登录
Stripe 文档徽标
/
询问人工智能
创建账户登录
开始
付款
销售收入
平台和交易市场
资金管理
开发人员资源
API 和 SDK帮助
概览
关于 Stripe 支付
升级您的集成
支付分析
线上付款
概览查找您的用例使用 Managed Payments
使用 Payment Link
使用预制结账页面
使用 Elements 构建自定义集成
构建应用内集成
线下支付
Terminal
    概览
    接受线下付款
    全球可用
    集成设计
    选择读卡器
      Stripe 读卡器 S700
      BBPOS WisePOS E
      Stripe Reader M2 读卡器
      BBPOS WisePad 3 读卡器
      Tap to Pay
      Verifone P400
      BBPOS Chipper 2X BT
    设计集成
    快速开始
    示例应用
    测试
    Terminal 设置
    设置您的集成
    用 Connect 进行多方付款
    连接读卡器
    接受付款
    收取银行卡付款
    其他支付方式
    支持线下支付
    邮购和电话订购付款
    地区考虑因素
    结账过程中
    收取小费
    收集并保存付款详情以供将来使用
    灵活授权
    结账后
    退款交易
    提供收据
    自定义 Checkout
    购物车显示
    收集屏幕输入内容
    收集刷卡数据
    收集 NFC 设备的轻触数据
    设备上的应用程序
    管理读卡器
    订购、退回、更换读卡器
    注册读卡器
    管理位置和区域
    配置读卡器
    监控读卡器
    参考
    API 参考
    移动读卡器
    智能读卡器
    Tap to Pay 阅读器
    SDK 迁移指南
    部署检查表
    Stripe Terminal 读卡器产品表
支付方式
添加支付方式
管理支付方式
用 Link 更快结账
支付场景
处理多种货币
自定义支付流程
灵活收单
编排
超越支付功能
成立公司
加密货币
智能体商务 (Agentic Commerce)
Financial Connections
Climate
了解欺诈
Radar 欺诈保护
管理争议
验证身份
美国
简体中文
首页付款TerminalSelect your reader

Tap to Pay

Learn how to accept contactless payments on a compatible iPhone or Android device.

Looking for a no-code solution? Accept payments from the Stripe Dashboard mobile app.

Use Tap to Pay on iPhone to accept in-person contactless payments with a compatible iPhone.

Tap to Pay on iPhone includes support for Visa, Mastercard, American Express contactless cards, and NFC-based mobile wallets (Apple Pay, Google Pay, and Samsung Pay). PIN entry is supported. Additionally, Discover is supported in the US, Interac is supported in Canada, and eftpos is supported in Australia. Stripe includes Tap to Pay on iPhone in the Terminal iOS SDK and the Terminal React Native SDK, and enables payments directly in your iOS mobile app.

注意

For platforms, use of Tap to Pay on iPhone is subject to the Apple Acceptance Platform User Terms and Conditions.

Availability

加拿大
德国
意大利
捷克
新西兰
法国
波兰
澳大利亚
爱尔兰
瑞典
美国
英国
荷兰
葡萄牙
西班牙

注意

Tap to Pay on iPhone isn’t available in Puerto Rico.

Availability in Public preview

丹麦
卢森堡
奥地利
挪威
新加坡
日本
比利时
瑞士
芬兰

Get started

Tap to Pay on iPhone introduces an SCPDiscoveryMethodTapToPay discovery option and a connectReader method. Integrate the latest version of the Terminal iOS SDK to include the latest bug fixes and features. You can view version-specific updates and bug fixes in the SDK changelog.

Device and minimum SDK version requirements can change due to updated compliance requirements or security vulnerabilities. To make sure your solution is up to date with Tap to Pay requirements, please subscribe to terminal-announce@lists.stripe.com.

To enable Tap to Pay in your iOS application:

  1. Request an entitlement.
  2. Set up the Terminal iOS SDK.
  3. Connect to the Tap to Pay reader.
  4. Collect the payment with the Tap to Pay reader.

Entitlements and build file

To use Tap to Pay on iPhone to accept payments in your application, you must first request and configure the Tap to Pay on iPhone development entitlement from your Apple Developer account. After you complete internal testing, you must request a distribution entitlement.

After you add the development entitlement file to your app build target, add the following:

Keycom.apple.developer.proximity-reader.payment.acceptance
Value typeboolean
Valuetrue or 1

Implementing Tap to Pay on iPhone is a complex process that requires submitting your app to Apple for approval. For detailed instructions, you can download our guide: Tap to Pay Guide (PDF)

Supported devices

Tap to Pay requires an iPhone XS or later running a one-year or later iOS version. Apple’s Business Register documentation lists supported iOS versions. Advise your users to update to the latest iOS version for the best performance.

注意

Tap to Pay won’t work on beta releases of iOS.

Cardholder verification limits and fallback

Some contactless card transactions above certain amounts might require additional cardholder verification methods (CVM) such as PIN entry. Tap to Pay on iPhone supports PIN entry for devices running iOS 16.4 or later.

NFC wallet payments (Apple Pay, Google Pay, and Samsung Pay) usually don’t require a PIN. However, in the UK, Canada, and Finland, regional requirements and card issuer policies can affect contactless payments.

In the UK, depending on the issuer, Strong Customer Authentication might require some cards to be inserted into a device. In such cases, if the card isn’t inserted, the payment is declined before the PIN screen appears, with the reason offline_pin_required.

In Canada and Finland, many issued cards are offline PIN only, meaning that entering the PIN requires physical contact, such as insertion into a device, which isn’t supported with Tap to Pay.

In these scenarios, we recommend asking the customer to try a different card or collecting payment in a different way. For example, using a Terminal card reader or sending a Payment Link.

When collecting payment with your mobile device, hold the card to the reader until it reads the chip information. You might need to wait a few seconds after the initial vibration when the card makes contact. In the event of a decline, use another method to collect payment, such as a Terminal card reader. You can only have one active connection to a reader at a time.

To test PIN entry in markets where PIN is accepted, use physical test cards with amounts ending in .03. In markets where PIN isn’t accepted, a transaction ending in .03 returns an online_or_offline_pin_required error code after the card is tapped, instead of allowing the user to test PIN entry.

Best practices and promotion guidelines

Follow the Human Interface Guidelines for Tap to Pay on iPhone to ensure of 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.
  • Use automatic reconnection to 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. With iOS 18, you can use Apple’s ProximityReaderDiscovery API to provide merchant education for Tap to Pay on iPhone with a few lines of code. Apple ensures that the content is up to date and localized for your merchant’s region.
  • Launch and promote your Tap to Pay on iPhone marketing campaigns using our messaging templates and design assets following Apple’s brand guidelines. Become a Stripe Partner here to access these assets in the partner portal.

Next steps

  • Set up your integration
此页面的内容有帮助吗?
是否
  • 需要帮助?联系支持。
  • 查看我们的更改日志。
  • 有问题?联系销售。
  • LLM? Read llms.txt.
  • Powered by Markdoc