Stripe创建订阅成功但latest_invoice.payment_intent为null问题咨询

核心成因梳理 #

• 场景1：首单发票金额为0
  如果你创建的订阅包含免费试用期、使用了100%抵扣的优惠券、订阅价格本身为0元，Stripe不会为0元交易生成Payment Intent，该字段自然为null，此时订阅会直接激活，不需要后续支付确认步骤。
• 场景2：首单支付无需用户交互自动完成
  你配置了payment_behavior: 'default_incomplete'，该参数的逻辑是：仅当首次支付需要用户额外操作（比如3D Secure验证、卡余额不足等）时，才会返回状态为incomplete的订阅及对应的Payment Intent；如果用户绑定的支付方式可直接完成扣款、无需额外交互，Stripe会后台自动完成支付，订阅直接变为active状态，此时Payment Intent已经执行完成，不会返回client_secret，甚至不会在返回对象中填充payment_intent字段。
• 场景3：Stripe API最终一致性延迟
  订阅创建是同步操作，但关联的发票生成、Payment Intent创建是异步链路，即使你添加了expand: ['latest_invoice.payment_intent']参数，极端低概率下异步流程未完全走完就返回了订阅对象，会出现字段为空的情况。
• 场景4：参数配置遗漏
  检查你传递的somePriceId对应的价格是否为recurring类型，一次性价格创建订阅时也可能出现发票关联逻辑异常，导致Payment Intent生成失败。

对应修复建议 #

你需要先判断订阅的状态和首单发票状态，再决定是否需要获取client_secret，不要一刀切校验payment_intent是否存在：

const createSubscription = async function(req, res) {
    const options = {
        customer: req.body.newlyCreatedId,
        items: [{price: req.body.price_id}],
        payment_behavior: 'default_incomplete',
        expand: ['latest_invoice.payment_intent'],
    }
    const subscription = await stripe.subscriptions.create(options);
    // 订阅已直接激活，无需后续支付操作
    if (subscription.status === 'active') {
        return res.json({
            success: true,
            subscriptionId: subscription.id,
            status: 'paid'
        });
    }
    // 仅未完成支付的订阅需要校验Payment Intent
    if (subscription.status === 'incomplete') {
        if(!subscription?.latest_invoice?.payment_intent?.client_secret){
            return res.json({error: "no_payment_intent",success: false});
        }
        return res.json({
            success: true,
            clientSecret: subscription.latest_invoice.payment_intent.client_secret,
            status: 'requires_payment_confirmation'
        });
    }
    // 其他状态按业务逻辑处理
    return res.json({success: false, error: 'subscription_status_error'});
}

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