Stripe订阅集成报错：传入SetupIntent密钥而非PaymentIntent密钥

核心错误原因 #

你调用stripe.confirmCardPayment时传入了SetupIntent的client secret，但这个API仅支持传入PaymentIntent的client secret，两者用途完全不同：

• PaymentIntent用于处理即时付款（比如订阅首月扣费场景）
• SetupIntent仅用于保存支付方式（比如免费试用后自动扣费场景）

分场景排查修复 #

场景1：业务需要用户订阅时立即付款 #

后端PHP修改

确保创建订阅时返回PaymentIntent的client secret，而非SetupIntent的：

// 创建订阅并关联PaymentIntent用于即时扣款
$subscription = \Stripe\Subscription::create([
    'customer' => $customer_id,
    'items' => [['price' => $price_id]],
    'payment_behavior' => 'default_incomplete',
    'expand' => ['latest_invoice.payment_intent'], // 展开获取关联的PaymentIntent
]);

// 返回PaymentIntent的client secret给前端
echo json_encode([
    'client_secret' => $subscription->latest_invoice->payment_intent->client_secret
]);

前端代码保持现有调用

继续使用stripe.confirmCardPayment，传入后端返回的PaymentIntent client secret即可。

场景2：业务仅需要保存支付方式（如免费试用） #

前端subscription.ts修改

将stripe.confirmCardPayment替换为stripe.confirmCardSetup，适配SetupIntent的验证逻辑：

// 替换原confirmCardPayment调用为以下代码
this.stripe.confirmCardSetup(clientSecret, {
    payment_method: {
        card: this.cardElement,
        billing_details: { name: this.userName } // 按需传入用户账单信息
    }
}).then((result) => {
    if (result.error) {
        console.error('支付方式保存失败:', result.error.message);
    } else {
        console.log('支付方式已保存:', result.setupIntent.payment_method);
        // 可在此处调用后端接口创建订阅
    }
});

后端PHP保持现有逻辑

如果只是保存支付方式，后端创建SetupIntent的代码无需修改，确保返回其client secret即可。

额外检查点 #

• 确认user-data服务传递给前端的client_secret类型，是否与前端调用的Stripe API匹配
• 检查HTML页面中Stripe Elements的初始化代码，确保加载了与业务匹配的Stripe JS版本

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