已开启Stripe客户门户优惠码权限，为何无法为现有订阅应用优惠码？

问题描述 #

已在Stripe客户门户设置中开启“允许客户使用优惠码”权限，但进入门户后无法找到添加优惠码的入口。订阅取消、支付方式更新、客户信息修改等配置的操作均可正常完成，仅无法应用优惠码。生产环境通过BillingPortalSession API打开门户，以及Stripe官方生成的链接均存在此问题。

当前计费门户配置：

"features": {
"customer_update": {
  "allowed_updates": [
    "email",
    "address",
    "phone"
  ],
  "enabled": true
},
"invoice_history": {
  "enabled": true
},
"payment_method_update": {
  "enabled": true
},
"subscription_cancel": {
  "cancellation_reason": {
    "enabled": true,
    "options": [
      "too_expensive",
      "missing_features",
      "switched_service",
      "unused",
      "other",
      "customer_service",
      "too_complex"
    ]
  },
  "enabled": true,
  "mode": "at_period_end",
  "proration_behavior": "none"
},
"subscription_pause": {
  "enabled": false
},
"subscription_update": {
  "default_allowed_updates": [
    "price",
    "promotion_code"
  ],
  "enabled": true,
  "proration_behavior": "create_prorations"
}
}

排查与解决步骤 #

1. 确认订阅状态与优惠码规则 #

• 优惠码入口仅对活跃状态的订阅可见，若订阅处于暂停、已取消（即使仍在剩余服务周期）状态，入口不会显示。
• 检查目标优惠码的限制条件：是否仅适用于特定订阅计划、客户是否已使用过该优惠码、优惠码是否已过期或达到使用次数上限。

2. 检查BillingPortalSession API调用配置 #

若通过API创建门户会话时指定了subscription_data.allowed_updates，会覆盖仪表盘的默认配置。如果该数组未包含promotion_code，则优惠码入口会被隐藏。

• 错误示例（覆盖了默认配置）：

  stripe.billing_portal.Session.create(
    customer="cus_xxxxxx",
    subscription_data={
      "allowed_updates": ["price"]  # 缺少promotion_code
    }
  )
  

• 修正方式：
  • 方案一：删除subscription_data.allowed_updates字段，让仪表盘的默认配置生效；
  • 方案二：明确在数组中加入promotion_code：

    stripe.billing_portal.Session.create(
      customer="cus_xxxxxx",
      subscription_data={
        "allowed_updates": ["price", "promotion_code"]
      }
    )
    

3. 确认门户界面的入口位置 #

Stripe客户门户中，优惠码入口并非首页直接显示的模块，需进入订阅管理页面（通常标注为「管理订阅」）才能找到添加优惠码的选项。如果客户只有一个订阅，需点击该订阅的管理入口进入对应页面。

4. 验证配置生效与环境一致性 #

• 重新保存一次Stripe仪表盘的客户门户配置，避免缓存导致配置未同步；
• 确认生产环境使用的配置与仪表盘上的设置一致，未混淆测试环境与生产环境的配置。

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