payin商户操作手册

最新文章

Stripe Checkout 混合购物车:开通费只进首次账单,哪些项目会续费?

在订阅模式结账中组合周期性服务与一次性开通费,分清首次收费与续费,并核对两类行项目及可选项目上限。

发布日期及来源核查日期:

适用于新建 Stripe Checkout 订阅中的固定周期性价格与一次性开通费;不涵盖试用、自定义账单锚点、已有项目修改、零金额履约或账户资格判断。仅为公开文档研究,未执行账户测试。

一、同一笔结账,不代表所有商品都会续费

一位开发者在公开提问中描述了这样的购物车:每月十美元的通行证,加上五美元的一次性商品,希望首次支付十五美元,之后每月支付十美元。他想知道是否必须禁止订阅和普通商品同时加入购物车。[3] 这说明存在具体的集成疑问,但不能用来推断问题发生率或市场规模。

Stripe Checkout 允许通过 line_items 传入一次性和周期性价格。只要结账会话包含至少一个周期性项目,就应使用 mode=subscription[1] 决定后续是否续费的是各个价格的计费类型,而不是客户是否在同一个页面购买。本指南只讨论新建订阅时搭配一次性开通费,不讨论修改已有订阅项目,也不讨论零金额订单履约。

二、为开通费配置独立的一次性价格

Stripe 的开通费示例要求先创建代表一次性费用的产品和价格,再创建结账会话。示例把周期性价格和一次性价格一起放入 line_items,分别指定数量,并选择订阅模式。[2] 文档也允许以内联方式创建一次性项目。[2]

建议在商品目录中分开标记持续服务与开通工作,由服务端解析已批准的价格标识,并检查开通费价格确实属于一次性类型。把周期性价格的名称改成“开通费”,并不能替代正确的计费类型选择。对于固定开通费,数量为一也应是经过确认的商业决定,而不是直接沿用其他商品数量。

三、把首次账单与续费账单分开解释

Stripe 明确说明,一次性价格对应的行项目仅出现在初始账单中。[1] 因此,将开通费价格加入新订阅购物车,不会使这项费用变成周期性订阅收费。周期性部分按照所选周期性价格计费,一次性部分归入初始账单。[1][2]

假设客户购买每月三十美元的服务及九十美元的开通费,数量都为一,没有试用、优惠、税费或其他账单调整:首次小计为一百二十美元,之后在服务不变的情况下,每月服务小计为三十美元。这只是解释上述规则的算术示例,不是实际执行的 Stripe 支付,也不是最终账单金额保证。

建议对客文案分别显示“首次服务费加开通费”和“后续每月服务费”,不要把首次总额标成固定续费金额。试用、自定义账单锚点及后续订阅变更不属于这个简化示例,应另外核对收费时间与账单构成。

四、周期性与一次性行项目分别计数

订阅模式的文档上限是二十个周期性价格行项目,以及二十个一次性价格行项目。[1] 这不是可任意分配的四十个总名额。例如,二十一个周期性行项目加一个开通费行项目,即使总数不到四十,仍超过周期性类别的上限。[1]

支付模式允许最多一百个行项目,但这项限制不适用于订阅模式的混合购物车。[1] 建议在创建会话前分别统计两类条目,不要把行项目数量和购买单位数混为一谈,也不要为了更大的名额而改用不符合购物车内容的模式。商品选择过多时,应先调整销售方案,而不是让客户进入结账后才遇到配置失败。

五、可选项目不能绕过分类上限

如果提供可选项目,Stripe 会将普通行项目与可选项目合并后应用相应类别上限;每个会话还最多允许十个可选项目。[1] 例如,十九个周期性行项目加两个周期性可选项目,已经超过周期性类别的文档上限,剩余的一次性名额不能补给这一类别。[1]

建议首版先采用固定服务搭配固定开通费。引入可选商品之前,将它们纳入同一套分类计数校验。本指南不据此断言所有结账界面、支付方式、币种或商户国家均支持相同配置;具体资格仍需独立确认。

六、发布前核对收费承诺,而不只核对总额

建议在自己的测试环境中对比已批准购物车、初始账单及后续周期账单:确认开通费首次出现、在未发生其他变更的续费中消失,并确认周期性服务行项目与批准金额一致。同时检查分类边界,在创建会话前拦截超限购物车。这些是拟议验收检查,本次研究没有执行这些测试。

为客服保留所选价格标识、计费类型、数量,以及首次与后续预期小计。若客户质疑续费,应先对照这份收费承诺,而不是仅凭首次总额猜测应退金额。资料检索日期为二〇二六年九月二十三日,来源发布日期和更新日期未能确定。社区提问仅用于证明具体需求,技术行为以官方文档为依据。本次未访问真实账户,未确定地区可用性,也不表示 PayIn 具备相同计费功能。

来源与日期

官方文档用于核对产品行为,社区问题仅说明具体需求,不代表普遍程度。检索日期为 2026-09-23,检索日期不等于发布日期。本文是文档研究,不是实际账户测试、PayIn 功能声明或金融建议。地区可用性和账户资格须另行确认。

更多指南

全部指南