管理定价套餐
在管理后台新建和编辑定价页展示、结账售卖的套餐,并为每种语言填写文案。
/pricing 展示上架的套餐,结账按套餐上保存的价格收费。套餐在 /admin/plans 管理。价格、币种、计费周期、积分、状态和排序属于套餐本身,对所有语言生效。名称、描述、按钮文字和功能列表按语言分别填写。
准备工作
- 拥有
plans.read(查看页面)和plans.write(保存)的管理员账号。Commerce Manager 角色两者都有,见角色与权限。 - 如果要让买家能付款,需要一个支付服务商,见接入支付服务商。
- 确定套餐键。订单和订阅通过套餐键引用套餐,创建后不能修改。
新建套餐
打开套餐页
进入 商业化 → 套餐(/admin/plans)。页面统计套餐总数、在定价页展示的数量、已隐藏的数量和订阅制的数量,并列出每个套餐的价格、积分、语言和状态。点击新建套餐,打开 /admin/plans/new。
填写套餐
| 字段 | 规则 |
|---|---|
| 套餐键 | 小写字母和数字,中间可用单个连字符或下划线分隔,最长 64 个字符;new 是保留字。创建后固定 |
| 价格 | 以币种的主单位填写,例如 29 或 29.50,可以为零。按最小货币单位存储 |
| 币种 | 三位代码,例如 USD 或 CNY |
| 计费周期 | 每月、每年、一次性或终身 |
| 赠送积分 | 不小于零的整数,订单付款后加到买家的积分余额 |
| 在定价页展示 | 打开时套餐为 active;关闭后套餐隐藏,结账会以 plan_inactive 拒绝 |
| 排序 | 整数,套餐按升序排列 |
计费周期决定套餐的收费方式。每月和每年的套餐是订阅,一次性和终身的套餐是单次付款。表单会显示当前适用哪一种。
为每种语言填写文案
在每种语言下填写名称、描述、按钮文字和功能列表。套餐包含的功能勾选包含,未勾选的功能显示为不包含。没有填写文字的功能行不会保存。
英文必填。名称留空的语言没有这个套餐的数据行。该语言的 /pricing 和结账都使用英文行,功能列表也是英文的。定价页用到的每种语言都应填写。
保存
点击创建套餐。保存被拒绝时,表单旁会指出问题,例如套餐键重复或币种不合法,此时不会写入任何数据。
编辑套餐
从列表打开套餐,改完后点击保存套餐。保存时,共享字段写入每个语言行,每种语言的文案和功能列表替换为表单里的内容。清空某种语言的名称会删除该语言的那一行及其功能列表。
改价只影响之后的新结账。已有订阅仍按支付服务商当前的扣款金额。
如果列表提示部分套餐的各语言行价格、周期或积分不一致,把这些套餐逐个打开并保存一次。保存会把相同的值写入所有语言行。
微信支付和支付宝只对以 CNY 计价、单次付款的套餐收款。启用其中任一个后,人民币套餐由它收款(优先微信支付),其它币种由默认服务商收款。Waffo 只能通过与套餐匹配的 Waffo 商品销售:一次性套餐需要一次性商品,月付或年付套餐需要对应周期的订阅商品。
验证套餐
- 用每种语言打开
/pricing。套餐出现在应有的位置,显示该语言的名称、价格和功能。隐藏的套餐不出现。 - 用普通用户登录,用服务商的测试卡购买这个套餐。
/admin/orders中订单金额等于套餐价格,套餐积分出现在买家的/app/credits。 /admin/audit中有billing.plan.created或billing.plan.updated,操作者是你的账号,目标是套餐键。pnpm validate:pricing-plans通过。
排查问题
结账返回 amount_mismatch
页面是在改价之前加载的。结账会把浏览器发来的金额、币种和模式与已保存的套餐比较,不一致时拒绝请求。刷新页面即可。
结账返回 plan_interval_mismatch
套餐行按订阅计费,但周期不是每月或每年,或者相反。只有不经后台写入的数据行才会出现这种情况。在 /admin/plans 打开该套餐并保存,之后计费模式由周期决定。
某种语言的定价页上,套餐显示英文文案
该语言没有这个套餐的数据行,定价页显示的是英文行。打开套餐,填写该语言的名称。