Waffo Pancake 注册到收款全流程教程

最近在小红书发现一个叫 Waffo 的支付渠道，由中国团队开发。当时他们正在招募内测用户，我申请并接入了。

整体使用感受不错，主要有三个特点：

1. 接入便捷 对个人开发者非常友好，无需注册公司即可申请。官方还提供了完整的集成指南（skill 和 llms-full.txt），可以直接让 AI 辅助对接，省去大量文档阅读时间。

2. MoR 模式（Merchant of Record） Waffo 作为 Merchant of Record，包揽支付、税务、合规、付款结算等全部中间环节。开发者只需专注于产品本身，不用分心处理全球各地的税务申报。

3. 国内支付支持（计划中） 面向国内市场的微信和支付宝正在接入中，预计近期上线。

下面我也让 Chatgpt 去帮忙调研了一下它跟其他一些主流支付渠道的区别：

注册到收款全流程实操

下面是从零开始接入 Waffo 的完整步骤，基于官方文档整理。

第一步：注册账号

访问 pancake.waffo.ai，支持三种方式登录：

• Google OAuth
• GitHub OAuth
• Magic Link（邮箱验证码）

注册即开通，前 $2,000 交易额免手续费。个人开发者可直接收款，无需注册公司。

第二步：创建商店

首次登录后会自动引导创建商店，只需填写商店名称即可。创建完成后你会获得一个 storeId。

第三步：创建产品并定价

路径：控制台 → 产品 → 创建产品

需要配置：

• 产品名称
• 计费类型：onetime（一次性）或 subscription（订阅）
• 价格：如 USD: { amount: "29.00", taxCategory: "digital_goods" }
• 订阅周期（如选订阅）：周 / 月 / 季 / 年

动态定价场景：创建一次性产品后，服务端计算金额，通过 priceSnapshot 传入。

第四步：获取 API 密钥

路径：Dashboard → Merchant → Integration → API Keys

记录两个关键值作为环境变量：

WAFFO_MERCHANT_ID=your-merchant-id
WAFFO_PRIVATE_KEY=your-rsa-private-key

第五步：集成 SDK

安装依赖：

npm install @waffo/pancake-ts

初始化客户端：

import { WaffoPancake } from "@waffo/pancake-ts";

const client = new WaffoPancake({
  merchantId: process.env.WAFFO_MERCHANT_ID!,
  privateKey: process.env.WAFFO_PRIVATE_KEY!,
});

创建结账会话（推荐认证式，防止试用滥用）：

const result = await client.checkout.authenticated.create({
  productId: "PROD_xxx",
  currency: "USD",
  buyerIdentity: "userIdInYourSystem",
  buyerEmail: "customer@example.com",
});
// 重定向到 result.checkoutUrl

匿名结账（适合未登录场景）：

const result = await client.checkout.anonymous.create({
  productId: "PROD_xxx",
  currency: "USD",
});

第六步：配置 Webhook

1. 准备 HTTPS 端点 服务端点需接受 POST 并返回 200。

2. 控制台配置 Webhook 路径：控制台输入端点 URL，选择订阅事件。

3. 签名验证（必须使用原始 body）

import { verifyWebhook } from "@waffo/pancake-ts";

app.post("/webhooks", express.raw({ type: "application/json" }), (req, res) => {
  const event = verifyWebhook(
    req.body.toString("utf-8"),
    req.headers["x-waffo-signature"] as string,
  );
  // event.eventType: order.completed / subscription.activated / ...
});

关键事件：

第七步：测试支付

切换测试环境：API 请求头加 -H "X-Environment: test"，或在控制台顶部切换。

测试卡号：

• 成功：4576 7500 0000 0110（Visa）
• 拒绝：4576 7500 0000 0220

验证 Webhook 是否收到 order.completed 事件，确认链路通畅。

第八步：上线（KYB + 收款配置）

1. 完成商业认证（KYB） 路径：设置 → 商业详情 提交身份/企业信息，审核通常 1-3 个工作日。

2. 绑定收款账户 路径：财务 → 付款设置 添加银行账户：

• CNY 通过支付宝到账
• 其他货币多为 SWIFT 转账
• 支持 19 个国家提现

3. 发布到生产环境 一键将产品从测试环境发布到生产环境，API 调用时移除 X-Environment: test 请求头。

提现规则

• 提现手续费：1%，最低 $10
• 结算周期：通常 1-3 个工作日审核到账
• Waffo 作为 MoR 已代扣税务合规，提现时无需额外处理税务

Waffo 需求反馈响应很快。相比 Stripe 那种工单-邮件来回的模式，沟通成本低得多，想支持的功能可以直接提。有兴趣的可以访问 waffo.ai 申请

如果你正在做 AI 工具、SaaS 或数字产品，需要一个能快速上手的 MoR 支付方案，Waffo 值得试试。

附上工作人员的联系方式，有问题可以找她咨询