带试用周期的Stripe订阅异常：Setup Intent密钥无法适配Elements

我正在基于Node.js和React栈的Web应用中集成Stripe支付功能，遇到以下问题：

1. 后端创建订阅的代码如下：

newSubscription = await stripe.subscriptions.create({
  customer: {{customerid},
  items: [
    {
      price: {{price}},
    },
  ],
  payment_behavior: 'default_incomplete',
  expand: ['pending_setup_intent'],
  trial_period_days: 7,
  off_session: true,
});

2. 添加试用周期时，获取到的客户端密钥为seti_XXXXX格式；无试用周期时，密钥为pi_XXX格式。
3. 使用Payment Intent（pi_开头）密钥时，Stripe Elements可正常工作并完成交易；但使用试用模式下的Setup Intent（seti_开头）密钥时，Elements报错：

{
  "error": {
    "code": "resource_missing",
    "doc_url": "https://stripe.com/docs/error-codes/resource-missing",
    "message": "No such payment_intent: 'seti_XXXXXXXXXXXXX'",
    "param": "intent",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_XXXXXXXXXXX",
    "type": "invalid_request_error"
  }
}

4. 尝试同时传入两种密钥，但试用模式下仍会使用Setup Intent密钥导致报错。

需求：实现带试用周期的订阅，且试用到期后自动从用户账户扣费。

核心问题原因 #

带试用的订阅场景下，Stripe会生成Setup Intent而非Payment Intent——因为此时不需要立即扣费，只需要预先保存支付方式用于后续自动扣费。你的前端代码错误地将Setup Intent的密钥当作Payment Intent传递给Elements，导致报错。

步骤1：后端区分Intent类型并返回 #

创建订阅后，根据是否包含试用周期，返回对应的Intent密钥及类型给前端：

// 创建订阅后
let intentSecret;
let intentType;
if (newSubscription.trial_period_days) {
  intentSecret = newSubscription.pending_setup_intent.client_secret;
  intentType = 'setup_intent';
} else {
  intentSecret = newSubscription.payment_intent.client_secret;
  intentType = 'payment_intent';
}

// 返回给前端
res.json({ intentSecret, intentType });

注意：修正后端代码的语法错误——customer: {{customerid}应改为customer: customerId（移除多余的花括号）。

步骤2：前端根据Intent类型处理 #

前端根据后端返回的intentType，调用对应的Stripe API：

无试用场景（Payment Intent）

const stripe = Stripe('你的公钥');
const elements = stripe.elements();

const paymentElement = elements.create('payment');
paymentElement.mount('#payment-element');

// 确认支付
const handleSubmit = async (e) => {
  e.preventDefault();
  const { error } = await stripe.confirmPayment({
    elements,
    confirmParams: {
      return_url: '你的回调地址',
    },
  });
  // 处理错误/成功逻辑
};

有试用场景（Setup Intent）

const stripe = Stripe('你的公钥');
const elements = stripe.elements();

const paymentElement = elements.create('payment');
paymentElement.mount('#payment-element');

// 确认保存支付方式
const handleSubmit = async (e) => {
  e.preventDefault();
  const { error } = await stripe.confirmSetup({
    elements,
    confirmParams: {
      return_url: '你的回调地址',
    },
  });
  // 处理错误/成功逻辑
};

步骤3：确保自动扣费生效 #

要让试用到期后自动扣费，需满足：

• 用户提供的支付方式支持自动扣费（如信用卡、借记卡）
• 订阅创建时off_session设为true（你已配置），允许Stripe无会话扣费
• Setup Intent状态为succeeded（即支付方式已成功保存）

内容的提问来源于stack exchange，提问作者RENJITH A B