Stripe创建订阅时报No such setupintent: 'pi_xxxx'错误排查求助

问题根因 #

你遇到的报错核心是Intent类型和调用方法不匹配：

• 服务端创建订阅时展开返回的latest_invoice.payment_intent是支付意图（PaymentIntent），ID前缀为pi_，对应的client_secret也是pi_xxx_secret_xxx格式
• 前端调用的stripe.confirmSetup()是专门用于处理设置意图（SetupIntent，ID前缀为seti_）的方法，调用时会默认将传入的client_secret对应的ID当作SetupIntent查询，自然会返回「不存在该SetupIntent」的错误

修复方案 #

1. 替换前端确认支付方法 #

将RegFormStripe组件中的stripe.confirmSetup替换为stripe.confirmPayment即可，修改后对应代码如下：

const { error } = await stripe.confirmPayment({
    elements,
    confirmParams: {
        return_url: 'http://localhost/payment-status'
    }
});

2. 补充Elements初始化必填参数 #

检查你未贴出的options配置，必须将服务端返回的clientSecret传入Elements初始化参数，否则PaymentElement无法正常关联支付意图：

// 从接口返回结果中拿到clientSecret
const clientSecret = 后端接口返回的payment.clientSecret;
const options = {
  clientSecret: clientSecret,
};
// 再传入Elements组件
<Elements stripe={stripePromise} options={options}>
    <RegFormStripe />
</Elements>

其他可能的排查项 #

如果修改后仍有报错，按以下顺序排查：

• 确认前后端密钥环境完全一致：测试环境下前后端都必须使用sk_test_xxx和pk_test_xxx，生产环境都必须使用sk_live_xxx和pk_live_xxx，跨环境调用即使密钥正确也无法查询到对应资源
• 确认API密钥属于同一个Stripe账户：如果有多个Stripe账户，不要混用不同账户的密钥
• 核对服务端返回的clientSecret完整性：不要截断pi_xxx_secret_xxx的任何部分，完整传递给前端
• 检查Stripe后台密钥权限：进入Stripe后台「开发者-API密钥」页面，确认使用的密钥没有被限制PaymentIntent、Subscription的读写权限

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