如何在Stripe订阅中添加ADDON？同一订阅能否添加不同类型多计划？

1. 如何在Stripe订阅中添加附加组件（Add-on）？ #

通过Stripe Dashboard操作 #

• 进入目标订阅详情页，找到「Items」板块，点击「Add item」按钮。
• 在弹出选项中选择已提前创建的附加组件产品（需确保产品类型为「Add-on」，对应价格为定期计费类型）。
• 确认附加组件的数量、价格参数后，保存修改即可完成添加。

通过API操作 #

调用订阅修改接口，在items参数中追加附加组件订单项，示例代码（Python）：

import stripe

stripe.api_key = "your_secret_key"

stripe.Subscription.modify(
    "sub_your_subscription_id",
    items=[
        # 保留原有订阅项（如需）
        {"id": "si_existing_item_id", "deleted": False},
        # 添加新附加组件
        {"price": "price_addon_id", "quantity": 1}
    ]
)

注意：附加组件的价格计费周期需与主订阅计划一致，否则无法添加。

2. 同一订阅能否添加不同类型的多个计划？ #

不能。Stripe订阅的核心逻辑是定期重复计费，不允许同时包含「Recurring（定期）」和「Single（一次性）」类型的计划，强行添加会触发系统报错。

替代解决方案 #

• 若需收取一次性费用，可单独创建发票项目（Invoice Item），关联到订阅所属客户后生成发票完成收费，此操作不会干扰原订阅的定期计费流程。
• 也可将一次性收费项创建为「One-time」类型的产品，通过发票项目单独收取，而非加入订阅项中。

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