集成Apple Tap to Pay时Stripe Terminal权限错误排查求助

问题场景 #

集成Apple Tap to Pay功能时，已按要求配置info.plist的com.apple.developer.proximity-reader.payment.acceptance权限：

<key>com.apple.developer.proximity-reader.payment.acceptance</key>
<true/>

调用以下代码时：

import StripeTerminal

func discoverReadersAction() {
    let config = DiscoveryConfiguration(
        discoveryMethod: .localMobile,
        simulated: false
    )

    self.discoverCancelable = Terminal.shared.discoverReaders(config, delegate: self) { error in
        if let error = error {
            print("discoverReaders failed: \(error)")
        } else {
            print("discoverReaders succeeded")
        }
    }
}

返回错误：

discoverReaders failed: Error Domain=com.stripe-terminal Code=2900
"Operation not permitted. Verify the app has the necessary
entitlements and that the application bundle is valid."
UserInfo={com.stripe-terminal:ReaderMessage=Error usually caused by an
entitlement issue, an invalid application bundle, a configuration
issue, or a token issue., NSLocalizedDescription=Operation not
permitted. Verify the app has the necessary entitlements and that
the application bundle is valid., com.stripe-terminal:Message=Operation
not permitted. Verify the app has the necessary entitlements and that
the application bundle is valid.}

根据Stripe文档，错误码2900（SCPErrorCommandNotAllowed）表示设备配置不支持，以下是权限配置相关的排查建议：

排查建议 #

• 确认权限配置完整性：Tap to Pay权限需在Apple开发者后台的App ID中开启，并确保Xcode自动生成的.entitlements文件包含com.apple.developer.proximity-reader.payment.acceptance权限，仅在info.plist中添加键值对无法生效。
• 核对Bundle ID一致性：Xcode项目的Bundle ID必须与开发者后台申请Tap to Pay权限的App ID完全匹配，包括大小写和后缀。
• 重新生成配置文件：创建并安装包含Tap to Pay权限的Provisioning Profile，旧配置文件可能未包含新增权限，导致运行时权限验证失败。
• 验证设备兼容性：Tap to Pay on iPhone仅支持以下设备：
  • iPhone XS及后续机型（含iPhone SE第二代及以后）
  • 运行iOS 15.5或更高版本
  • 设备NFC功能未被系统禁用
• 检查SDK版本：确保使用Stripe Terminal iOS SDK v2.20.0及以上版本，旧版本不支持Tap to Pay on iPhone功能。
• 确认Stripe账户状态：你的Stripe账户需已开启Tap to Pay on iPhone功能，且商户信息完成身份验证、所在地区支持该服务。

内容的提问来源于stack exchange，提问作者adalovelacy