Stripe更新订阅并添加3D Secure新支付方式时PaymentIntent异常问题

问题原因 #

你的代码逻辑存在分支配置缺失：只有s.CreatePaymentIntent为true时才会设置payment_behavior=allow_incomplete、展开latest_invoice.payment_intent字段；当你走修改套餐的分支（s.ItemID != ""）时，这两个关键配置都没有生效，导致Stripe不会生成新的待确认Payment Intent，只会返回历史已完结的旧Payment Intent，调用确认接口时就会抛出payment_intent_unexpected_state错误。

修复方案 #

1. 将核心通用配置从条件分支中移出，所有涉及订阅金额变动、支付方式更换的更新操作，都要配置payment_behavior和字段展开规则
2. 调整订阅套餐修改的参数写法，无需先删除旧订阅项再新增，直接给原有订阅项指定新价格即可，避免逻辑异常
3. 若仅更换支付方式不需要修改套餐，可强制开启3D Secure认证触发新Payment Intent生成

修正后代码示例 #

func (c *Client) UpdateSubscription(s *models.Subscription) (*models.Subscription, error) {
    sps := &stripe.SubscriptionParams{
        DefaultPaymentMethod: stripe.String(s.PaymentMethodId),
        CancelAtPeriodEnd:    stripe.Bool(false),
        ProrationBehavior:    stripe.String(string(stripe.SubscriptionProrationBehaviorAlwaysInvoice)),
        // 通用配置移到外层，所有更新场景都生效
        PaymentBehavior: stripe.String("allow_incomplete"),
    }
    // 所有场景都展开需要的Payment Intent字段
    sps.AddExpand("latest_invoice.payment_intent")

    if s.ItemID != "" {
        // 直接修改原有订阅项的价格，无需删除后新增
        sps.Items = []*stripe.SubscriptionItemsParams{
            {
                ID:    stripe.String(s.ItemID),
                Price: stripe.String(s.PriceID),
            },
        }
    }

    // 若仅更换支付方式不需要改套餐，可添加强制3D Secure配置触发新认证
    if s.OnlyUpdatePaymentMethod {
        sps.PaymentSettings = &stripe.SubscriptionPaymentSettingsParams{
            PaymentMethodOptions: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsParams{
                Card: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsCardParams{
                    Require3dSecure: stripe.String("any"),
                },
            },
        }
    }

    ss, err := sub.Update(s.ID, sps)
    if err != nil {
        return nil, err
    }

    if ss.LatestInvoice != nil && ss.LatestInvoice.PaymentIntent != nil {
        s.PaymentIntentClientSecret = ss.LatestInvoice.PaymentIntent.ClientSecret
    }
    return s, nil
}

注意事项 #

• 拿到新的Client Secret后，要确认Payment Intent的状态为requires_action或者requires_confirmation之后再调用前端确认接口，避免再次抛出状态异常错误
• 若更新订阅后没有产生差价金额，Stripe不会生成新的Invoice，此时需要单独调用Setup Intent接口完成新支付方式的验证，再绑定到订阅上

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