产品 - Waffo Pancake

产品 = 计费对象

在 Waffo Pancake 中，产品（Product） 是用于收银台、计税和归档的对象。它是你对外收费的商业化”报价单”，而不仅仅是一张展示卡片。

更专业的理解方式是：把产品视为计费实体：

一个固定价格的报价
一个订阅方案
或一个用于收银台动态定价的基础产品

核心建模方式

一次性付款

用户为预设价格支付一次。

数字下载
终身许可证
模板、课程、素材

订阅制

用户按固定周期持续支付。

SaaS 方案
会员制
服务合同

动态定价

金额在收银台时计算。

超额用量
充值包
按报价收费

创建产品

控制台 → 产品 → 创建产品

{
  "storeId": "your-store-uuid",
  "name": "Pro Plan",
  "prices": {
    "USD": { "amount": "29.00", "taxIncluded": false, "taxCategory": "saas" }
  }
}

完成。 你会得到一个固定价格产品的永久购买链接，或者一个可被程序化收银台复用的计费对象。

产品字段

必填项

字段	说明
名称	你的消费者看到的内容
价格	收费金额
货币	USD、EUR、GBP、JPY、HKD（CNY 仅一次性商品，见下方价格限制）
类型	一次性收费或订阅计费
商品类别	SaaS、数字商品、软件等

选填项

字段	默认值	用途
描述	—	Markdown 格式，用于推销产品
图片	—	推荐 400x400px
跳转 URL	—	结账完成后客户的落地地址。支付成功与失败都使用同一个地址 — 只支持配置一个。

价格限制

每种币种都有可设置的最低和最高价格，超出范围的价格在保存商品时会被拒绝。

币种	最低	最高
USD	$1.00	$7,500.00
EUR	€1.00	€7,400.00
GBP	£1.00	£6,400.00
JPY	¥100	¥1,250,000
CNY	¥1.00	¥1,000.00
HKD	HK$8.00	HK$61,000.00

CNY 仅用于一次性商品定价 —— 订阅商品不支持 CNY。按 CNY 定价的订单只能用微信支付，且单笔约 1,000 CNY 以内。详见支付方式与币种对应。

动态定价

当最终收费金额要在运行时计算时，应使用动态定价。典型场景：

超额用量收费
可变额度充值
按合同报价收费
服务端实时计算折扣后的金额

实现方式

在 Waffo Pancake 中创建一个基础一次性产品
在服务端计算最终金额
创建 Checkout Session 时传入 priceSnapshot

const session = await client.checkout.createSession({
  storeId: "store_id",
  productId: "usage-overage-product-id",
  productType: "onetime",
  currency: "USD",
  priceSnapshot: {
    amount: calculatedAmount,
    taxIncluded: false,
    taxCategory: "saas",
  },
});

priceSnapshot 会覆盖该次收银台使用的产品价格。它必须由服务端生成，不能从不可信的客户端直接传入。

如果收费是事件型、按实际发生量计算的，即使客户本身属于订阅用户，这笔收费也应继续建模为一次性收费。

免费试用

让客户在购买前试用订阅产品。

试用滥用保护

Waffo Pancake 在平台层面自动追踪消费者的试用历史。当消费者开始新的订阅时，平台会根据其历史记录计算最大可用试用天数——无需商户做任何额外操作即可防止重复试用滥用。商户也可以通过 API 传递 requested_trial_days 来为特定客户缩短或跳过试用期。

有效的试用滥用防护需要 buyerIdentity。使用认证式收银台确保每个买家对每个产品只能领取一次试用。

计费周期

周期	频率	最适用于
每周	每 7 天	高使用量产品
每月	每月	标准 SaaS
每季度	每 3 个月	B2B 软件
每年	每 12 个月	长期客户

年付方案打 15-20% 折扣 = 更低的流失率 + 更好的现金流。

产品购买链接

每个产品都拥有一个永不过期的固定购买链接：

https://checkout.waffo.ai/{store-slug}/{product-slug}

测试模式：

https://checkout.waffo.ai/{store-slug}/{product-slug}/test

绑定到你的网站：

网站按钮
Twitter 简介
邮件签名
Discord 服务器

核心优势：

链接是永久的——即使你更新产品信息，链接也保持不变
无需管理会话或令牌
客户打开链接时，收银台会话会自动创建

生成你的链接：

控制台：在任意产品上点击”复制链接”
API：在更高级的场景下，可通过 API 创建带自定义参数的 Checkout Session（动态链接，TTL 为 7 天）

测试与正式环境：

在控制台顶部切换测试模式即可使用测试链接进行预览
测试链接使用 /test 后缀

产品状态

Active

已上线，客户可以购买。

Inactive

已隐藏，现有订阅继续有效。

更新产品

产品采用不可变版本控制：

更新会创建新版本。现有订阅保持其原始版本不变。

字段	影响
名称/描述	创建新版本
图片	创建新版本
价格	仅影响新购买
计费周期	创建后无法更改

环境同步

将产品版本从测试环境发布到生产环境：

POST /v1/actions/onetime-product/publish-product
{
  "id": "product-id"
}

发布是单向的（测试 → 生产），只在首次发布时需要。

最佳实践

命名

包含计费周期：

“Pro Plan - Monthly”
“Pro Plan - Annual (Save 20%)”

定价

使用整数价格（ $29，而非$ 28.73）
年付折扣（15-20%）
研究竞争对手

图片

最小 400x400px
PNG 或 JPG 格式
小于 2MB

开始使用

功能

商户

商店

记录商

产品

产品 = 计费对象

核心建模方式

一次性付款

订阅制

动态定价

创建产品

产品字段

必填项

选填项

价格限制

动态定价

实现方式

免费试用

试用滥用保护

计费周期

产品购买链接

产品状态

Active

Inactive

更新产品

环境同步

最佳实践

​产品 = 计费对象

​核心建模方式

一次性付款

订阅制

动态定价

​创建产品

​产品字段

​必填项

​选填项

​价格限制

​动态定价

​实现方式

​免费试用

​试用滥用保护

​计费周期

​产品购买链接

​产品状态

Active

Inactive

​更新产品

​环境同步

​最佳实践

产品 = 计费对象

核心建模方式

创建产品

产品字段

必填项

选填项

价格限制

动态定价

实现方式

免费试用

试用滥用保护

计费周期

产品购买链接

产品状态

更新产品

环境同步

最佳实践