Skip to main content

先选接入路径

AI 集成

最快落地适合已有代码仓库,希望借助 Claude Code 等编码代理完成方案设计、接口接入和联调验证的团队。

API / SDK

最可控适合需要自定义收银台流程、服务端编排、动态定价,或希望对集成行为有更精细控制的场景。

托管收银台

最简单适合先快速上线支付链接、后续再逐步深化集成的团队。

先理解“产品”是什么

在 Waffo Pancake 中,产品(Product) 是用于收银台和税务处理的计费对象,不只是一个商品展示卡片或 SKU。
如果你的业务以订阅为主,仍然可能创建一次性收费,例如开通费、附加服务、超额计费或充值包。这是正常的建模方式。

用 AI 集成支付

简单版本

直接告诉你的 AI 助手:
就这一句。Skill 文件包含 AI 所需的一切 — API 端点、SDK 用法、Webhook 处理和最佳实践。

完整版本

你也可以描述自己的技术栈,获得更有针对性的集成:

AI 集成指南

查看统一的 AI 集成入口,包含 Skill 上下文、SDK 用法、代码示例、产品目录设计和动态定价流程。

5 分钟开始收款

无需信用卡。无需注册公司。注册即可开始销售。
Get Started Steps

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
把产品目录理解成你的计费模型:固定价格产品对应标准报价,订阅产品对应周期性服务,priceSnapshot 对应运行时定价。

4. 集成支付

产品创建好了?你会获得一个收银台链接,添加到你的网站:
添加到你网站的产品页面即可。完成。
此链接是永久的 — 永不过期,即使更新产品也依然有效。只需在控制台中点击“复制链接”。

5. 收款

客户付款 → 我们处理税务 → 你收到打款。 资金直接进入你的银行账户。无中间商。无延迟。
商户财务 — 余额与打款

测试 vs 正式

测试模式

  • 无真实扣款
  • 安全实验
  • 独立测试数据

正式模式

  • 真实支付
  • 真实打款
  • 准备好时切换
在控制台顶部切换。 API 中通过 X-Environment 请求头切换。始终先在测试环境验证。

测试卡号

成功支付

拒绝支付

任意未来有效期,任意 CVC。

上线清单

切换到正式模式前:
  • 端到端测试收银台流程
  • 验证 Webhook 端点(如使用)
  • 添加打款账户(打款账户页)
  • 完成商业信息(设置 → 商业详情)
  • 检查产品定价
  • 将产品从测试环境同步到生产环境
  • 将 API Key 换为生产环境 Key
  • 将 webhook 验签公钥换为生产环境公钥
产品 ID 在测试与生产环境之间保持一致,代码里的 ID 不需要改。必须换的只有两样:API Key 和 webhook 验签公钥。

下一步?

产品

定价模型。试用。周期。

订阅

循环计费。催款。生命周期。

收银台

你的品牌。你的颜色。我们的基础设施。

集成

API 密钥。Webhooks。你的后端。

需要帮助?

加入 Discord

社区支持。快速解答。