先选接入路径
AI 集成
最快落地适合已有代码仓库,希望借助 Claude Code 等编码代理完成方案设计、接口接入和联调验证的团队。
API / SDK
最可控适合需要自定义收银台流程、服务端编排、动态定价,或希望对集成行为有更精细控制的场景。
托管收银台
最简单适合先快速上线支付链接、后续再逐步深化集成的团队。
先理解“产品”是什么
在 Waffo Pancake 中,产品(Product) 是用于收银台和税务处理的计费对象,不只是一个商品展示卡片或 SKU。如果你的业务以订阅为主,仍然可能创建一次性收费,例如开通费、附加服务、超额计费或充值包。这是正常的建模方式。
用 AI 集成支付
简单版本
直接告诉你的 AI 助手:完整版本
你也可以描述自己的技术栈,获得更有针对性的集成:AI 集成指南
查看统一的 AI 集成入口,包含 Skill 上下文、SDK 用法、代码示例、产品目录设计和动态定价流程。
5 分钟开始收款
无需信用卡。无需注册公司。注册即可开始销售。
1. 创建账户
访问 商户控制台,使用 Google、GitHub 或 Magic Link 注册。商户控制台
使用 Google、GitHub 或 Magic Link 注册 — 无需信用卡。
- Google OAuth — 一键完成。
- GitHub OAuth — 为开发者准备。快速简单。
- Magic Link — 输入邮箱。点击链接。完成。
2. 创建商店
首次登录时会触发商店设置:无需商业注册。欢迎独立创始人。
3. 创建首个产品
控制台 → 产品 → 创建产品
billingPeriod(weekly、monthly、quarterly、yearly)。
如果你的商户账户下有多个商店,创建产品前先确认这个产品应该属于哪个商店。
如果你提供 Starter / Pro / Enterprise 这类多套餐:
- 每个套餐创建为一个订阅产品
- 先把每个套餐的定价和计费周期定义清楚
- 先创建一个基础的一次性产品,例如
Usage Overage - 在服务端计算最终金额
- 创建收银台会话时传入
priceSnapshot
4. 集成支付
产品创建好了?你会获得一个收银台链接,添加到你的网站:此链接是永久的 — 永不过期,即使更新产品也依然有效。只需在控制台中点击“复制链接”。
5. 收款
客户付款 → 我们处理税务 → 你收到打款。 资金直接进入你的银行账户。无中间商。无延迟。
测试 vs 正式
测试模式
- 无真实扣款
- 安全实验
- 独立测试数据
正式模式
- 真实支付
- 真实打款
- 准备好时切换
X-Environment 请求头切换。始终先在测试环境验证。
测试卡号
成功支付
拒绝支付
任意未来有效期,任意 CVC。
上线清单
切换到正式模式前:- 端到端测试收银台流程
- 验证 Webhook 端点(如使用)
- 添加打款账户(打款账户页)
- 完成商业信息(设置 → 商业详情)
- 检查产品定价
- 将产品从测试环境同步到生产环境
- 将 API Key 换为生产环境 Key
- 将 webhook 验签公钥换为生产环境公钥
产品 ID 在测试与生产环境之间保持一致,代码里的 ID 不需要改。必须换的只有两样:API Key 和 webhook 验签公钥。
下一步?
产品
定价模型。试用。周期。
订阅
循环计费。催款。生命周期。
收银台
你的品牌。你的颜色。我们的基础设施。
集成
API 密钥。Webhooks。你的后端。
需要帮助?
加入 Discord
社区支持。快速解答。