Stripe：初始支付金额为0时如何获取客户端密钥？

当优惠券导致订阅初始金额为0时，Stripe不会生成带Payment Intent的待支付发票，自然无法通过原逻辑获取客户端密钥。你可以通过以下两种实用方式解决：

方式一：直接创建Setup Intent保存支付方式 #

如果只是需要验证并保存用户支付方式（用于后续订阅周期扣费），可以跳过订阅创建时的支付流程，直接创建Setup Intent：

const setupIntent = await stripe.setupIntents.create({
  customer: customer.id,
  payment_method_types: ['card'], // 可根据业务需求添加其他支付方式类型
});
// 用setupIntent.client_secret渲染Payment Element即可

用户完成Payment Element的验证流程后，支付方式会自动关联到对应客户账号，后续订阅的正常扣费会自动触发。

方式二：分场景调整订阅创建逻辑 #

在创建订阅前先预判金额是否为0，拆分不同处理逻辑：

1. 先通过价格和优惠券信息计算初始应付金额
2. 金额大于0时，沿用原订阅创建逻辑获取支付Intent的密钥
3. 金额为0时，直接创建完整订阅，再单独创建Setup Intent获取密钥

示例代码：

// 计算初始应付金额
const priceDetails = await stripe.prices.retrieve(price);
const couponDetails = coupon ? await stripe.coupons.retrieve(coupon) : null;
const initialAmount = priceDetails.unit_amount * priceDetails.recurring.interval_count;
const discountedAmount = couponDetails 
  ? initialAmount * (1 - couponDetails.percent_off / 100) 
  : initialAmount;

let clientSecret;
let subscription;

if (discountedAmount > 0) {
  // 正常金额场景：按原逻辑创建订阅并获取支付密钥
  subscription = await stripe.subscriptions.create({
    customer: customer.id,
    items: [{ price }],
    payment_behavior: "default_incomplete",
    payment_settings: { save_default_payment_method: "on_subscription" },
    expand: ["latest_invoice.payment_intent"],
    coupon: coupon || undefined,
  });
  clientSecret = subscription.latest_invoice.payment_intent.client_secret;
} else {
  // 零金额场景：创建订阅+单独生成Setup Intent
  subscription = await stripe.subscriptions.create({
    customer: customer.id,
    items: [{ price }],
    coupon: coupon || undefined,
    payment_settings: { save_default_payment_method: "on_subscription" },
  });
  const setupIntent = await stripe.setupIntents.create({
    customer: customer.id,
  });
  clientSecret = setupIntent.client_secret;
}

这种方式能覆盖所有场景，确保无论初始金额是否为0，都能拿到可用的客户端密钥渲染Payment Element，同时保证支付方式被正确保存。

关键注意点 #

• Setup Intent仅用于验证和保存支付方式，不会产生实际扣费，完全适配零金额初始订阅场景
• 初始化Payment Element时无需强制指定mode: 'payment'，Stripe会自动识别Setup Intent模式

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