iOS端集成Stripe 3D Secure支付遇阻，寻求技术帮助

我完全懂这种卡壳的挫败感——Stripe的3D Secure在iOS上的实现确实藏得有点深，官方文档的细节常常不够落地，论坛讨论也少得可怜。我之前踩过不少坑，给你梳理几个关键的落地步骤，应该能帮你打通流程：

1. 先确认Stripe SDK版本 #

确保你用的是最新版的Stripe iOS SDK，旧版本的3D Secure实现逻辑和新版差异很大，很多旧教程的代码已经失效了。你可以通过pod update Stripe来更新，或者在Xcode的Package Manager里确认版本。

2. 核心流程的正确打开方式 #

Stripe的3D Secure本质是基于STPPaymentIntent（现在主推的方案）或STPSource（旧方案）触发验证，别搞混两种逻辑：

方案一：用PaymentIntent（推荐，Stripe官方主推） #

如果你的后端用PaymentIntent处理支付，iOS端关键步骤如下：

• 从后端获取clientSecret（后端创建PaymentIntent后返回的核心凭证）
• 初始化STPPaymentHandler，调用confirmPayment方法传入卡片信息和clientSecret
• 实现STPPaymentHandlerDelegate回调，处理3D Secure验证跳转：

  func paymentHandler(_ handler: STPPaymentHandler, didReceive nextAction: STPIntentAction, for paymentIntent: STPPaymentIntent, completion: @escaping STPIntentActionCompletionBlock) {
      // 触发3D Secure验证页面
      if nextAction.type == .redirectToURL {
          handler.presentPaymentAuthViewController(with: nextAction.redirectToURL!, from: self)
      }
  }
  
  func paymentHandlerDidCancel(_ handler: STPPaymentHandler) {
      // 用户取消验证的处理逻辑
  }
  
  func paymentHandler(_ handler: STPPaymentHandler, didFinish status: STPPaymentHandlerActionStatus, paymentIntent: STPPaymentIntent?, error: Error?) {
      // 验证完成，根据状态处理结果
      if status == .succeeded {
          // 支付成功，通知后端完成后续流程
      } else {
          // 处理失败或取消的情况
      }
  }
  

方案二：用Source（旧方案，仅适用于遗留项目） #

如果仍在使用Source方案，步骤如下：

• 创建3D Secure Source（后端或前端调用Stripe API，需传入卡片sourceId、金额、币种）
• 获取STPSource后，检查其status是否为requiresAction，若是则调用STPSourceHandler触发验证：

  let sourceHandler = STPSourceHandler()
  sourceHandler.handleAction(for: source, with: self) { (status, source, error) in
      switch status {
      case .succeeded:
          // 验证成功，提交source到后端完成支付
      case .failed:
          // 验证失败，提示用户
      case .canceled:
          // 用户取消验证
      }
  }
  

3. 最容易踩的坑 #

• 后端配置必须到位：3D Secure触发需要后端在创建PaymentIntent/Source时，正确设置amount、currency；欧洲地区卡片会强制触发验证，后端不能跳过该逻辑。
• 验证页面跳转权限：确保你的ViewController是当前顶层控制器，否则presentPaymentAuthViewController可能失败，导致看不到验证页面。
• 测试卡片选择：用Stripe提供的专用测试卡，比如4000000000003220（会触发3D Secure验证），普通测试卡无法触发验证流程。

4. 调试技巧 #

• 打开Stripe Dashboard的支付日志，查看Source/PaymentIntent的状态变化（比如requiresAction或failed），快速定位是前端还是后端问题。
• 在Xcode中开启Stripe日志：STPPaymentConfiguration.shared().enableLogging = true，可以看到SDK内部的请求和错误细节。

相信把这些步骤理清楚，你应该能打通3D Secure的流程了——当初我也是卡在后端配置和验证页面跳转这两步，调整后就顺利跑通了。

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