iOS端Stripe PaymentSheet配置报错：PaymentIntent状态异常如何解决

报错PaymentSheet received a PaymentIntent in an unexpected state: STPPaymentIntentStatus的核心原因是：传入PaymentSheet初始化的PaymentIntent状态不符合要求，仅处于requires_payment_method状态的PaymentIntent可用于PaymentSheet初始化。

常见触发原因 #

• 复用了已完成支付、已取消的PaymentIntent的client_secret，同一个PaymentIntent仅可用于一次支付流程
• 服务端创建PaymentIntent时指定了错误的初始状态，未停留在requires_payment_method阶段
• 前端初始化PaymentSheet前，已通过其他接口修改了对应PaymentIntent的状态，例如提前触发了支付确认逻辑
• 误将SetupIntent的client_secret传入了PaymentSheet的paymentIntentClientSecret参数，两类Intent的client_secret前缀不同，PaymentIntent前缀为pi_，SetupIntent前缀为seti_

排查修复步骤 #

• 打印你获取到的client_secret值，首先确认前缀为pi_，排除Intent类型传错的问题
• 服务端创建PaymentIntent后，先查询其状态，确认返回的status字段为requires_payment_method后，再将client_secret返回给前端
• 检查前端业务逻辑，确认初始化PaymentSheet前，没有调用过STPAPIClient相关的支付确认接口修改该PaymentIntent的状态
• 如果业务逻辑需要复用之前生成的PaymentIntent，初始化PaymentSheet前先调用接口查询其当前状态，如果状态为succeeded/canceled/requires_capture，需重新生成新的PaymentIntent再初始化PaymentSheet

优化后的代码示例 #

你可以在现有逻辑基础上增加PaymentIntent状态预校验逻辑，避免直接弹出报错：

StripeAPI.defaultPublishableKey = KeyStripe
var configuration = PaymentSheet.Configuration()
configuration.merchantDisplayName = "你的商户名称" // 建议补全该参数，避免部分场景下的适配问题

// 先预校验PaymentIntent状态
STPAPIClient.shared.retrievePaymentIntent(withClientSecret: client_secret) { [weak self] intent, error in
    guard let intent = intent, error == nil else {
        self?.displayAlert(title: "支付参数错误", message: error?.localizedDescription ?? "无效的支付凭证")
        return
    }
    // 仅状态为requiresPaymentMethod时允许初始化PaymentSheet
    guard intent.status == .requiresPaymentMethod else {
        self?.displayAlert(title: "支付状态异常", message: "请重新发起支付")
        return
    }
    
    let paymentSheet = PaymentSheet(
        paymentIntentClientSecret: client_secret,
        configuration: configuration)
    
    paymentSheet.present(from: self!) { [weak self] (paymentResult) in
        switch paymentResult {
        case .completed:
            self?.displayAlert(title: "Payment complete!")      
        case .canceled:
            print("Payment canceled!")
        case .failed(let error):
            self?.displayAlert(title: "Payment failed", message: error.localizedDescription)
        }
    }
}

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