如何在Stripe新版结账中添加负行项目或等效折扣
Stripe Checkout 自定义折扣无负行项目可行解决方案
以下是三种可直接落地的适配方案,所有方案的折扣计算逻辑均保留在你的店铺引擎侧,无需提前在Stripe后台维护折扣规则,也不需要做双向数据同步:
方案一:动态创建抵扣价格项加入行项目列表
你无需提前在Stripe后台新建固定商品/价格,直接在调用checkout.sessions.create接口前,通过prices.create接口动态创建专属抵扣价格对象:- 价格的
currency设置为和订单一致的币种,unit_amount设置为你计算得出的总折扣金额的负数绝对值,product_data内可自定义填写折扣名称(如「指定商品9折抵扣」「运费满减」「整单优惠」等),同时可添加元数据标记折扣类型,方便后续对账匹配 - 将创建完成的价格ID直接加入Checkout会话的
line_items列表即可,Stripe会将其作为单独行项目展示在结账页,用户可直观看到抵扣明细
适用场景:需要拆分展示多个不同类型折扣、要求折扣单独作为行项目留存订单记录的场景
- 价格的
方案二:直接调整原有行项目的结算单价
如果你不需要单独展示折扣行,可以在引擎侧完成折扣分摊计算后,直接调整对应行项目的单价为折扣后价格:- 若为商品折扣,直接调整对应商品
line_items的price_data.unit_amount为折扣后单价,可在description字段补充「已享X折优惠」等说明 - 若为运费折扣,直接调整运费项的金额即可,也可以在Checkout会话的
custom_text区域添加整单折扣说明,告知用户优惠明细
适用场景:折扣已分摊到单个商品/运费项,不需要单独留存折扣行记录的场景,该方案接口调用量最少,实现成本最低
- 若为商品折扣,直接调整对应商品
方案三:动态创建一次性优惠券传入会话折扣参数
如果你希望使用Stripe原生的折扣展示样式,可在创建Checkout会话前,通过coupons.create接口动态创建一次性优惠券:- 将优惠券的
amount_off设置为你计算得出的总折扣金额,duration设置为once(仅单次生效),无需后续维护 - 创建完成后将优惠券ID传入Checkout会话的
discounts参数,Stripe会自动在结账页原生位置展示折扣抵扣项
适用场景:不需要拆分多个折扣项、希望适配Stripe原生账单样式的场景
- 将优惠券的
注意:以上方案中所有动态创建的
price、coupon对象均不会在你的Stripe后台生成冗余的固定配置,也不需要做双向数据同步,所有折扣规则的控制权完全保留在你的店铺引擎侧。
内容的提问来源于stack exchange,提问作者Kakaraji
相关产品推荐
相关产品推荐

