Documentation Index
Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
Use this file to discover all available pages before exploring further.
两步结账
消费者通过简洁的两步流程完成支付，优化转化率。
消费者信息
收集邮箱、国家和账单信息，用于税费计算和订单处理。
支付
输入卡片信息或使用 Apple Pay / Google Pay 完成支付。
第 1 步：消费者信息
收集税费计算和订单处理所需的信息。
| 字段 | 必填 | 说明 |
|---|
| 邮箱 | 是 | 用于收据、账户创建和客户门户访问 |
| 国家 | 是 | 用于税费计算 |
| 企业购买 | 否 | 勾选后显示企业名称和税号字段 |
第 2 步：支付
消费者选择支付方式并完成付款。
支持的支付方式
卡片支付
- Visa（信用卡 / 借记卡）
- Mastercard（信用卡 / 借记卡）
- 3D Secure 自动处理
数字钱包
- Apple Pay（Safari / iOS）
- Google Pay（Chrome / Android）
- 一键完成，无需输入卡号
订单摘要
| 项目 | 说明 |
|---|
| 小计 | 产品价格 |
| 税费 | 根据消费者所在地区自动计算 |
| 总计 | 最终收费金额 |
订阅结账
订阅产品的结账页面会显示额外信息：
| 信息 | 说明 |
|---|
| 计费周期 | 月付 / 季付 / 年付 |
| 首次收费 | 试用结束后的首次扣款日期 |
| 试用期 | 试用天数和结束日期（如有） |
| 自动续费 | 到期自动续费，可随时取消 |
税费处理
Waffo Pancake 自动计算并收取税费。
| 模式 | 行为 |
|---|
| 外加 | 税费单独显示，加到产品价格上 |
| 内含 | 价格已包含税费，显示为分解明细 |
- 销售税（美国）
- 增值税 VAT（欧洲）
- 商品及服务税 GST（澳大利亚、加拿大）
支付结果
- 显示订单确认页面
- 发送确认邮件（含收据）
- 如设置了
successUrl，自动跳转
- 显示错误原因和重试选项
- 常见原因：卡片被拒、余额不足、3D Secure 验证失败
| 错误 | 原因 | 消费者操作 |
|---|
| 卡片被拒 | 余额不足或银行拦截 | 尝试其他卡片 |
| 无效卡片 | 卡号错误 | 检查并重新输入 |
| 过期卡片 | 卡片已过期 | 使用有效卡片 |
| 3DS 失败 | 银行验证失败 | 联系银行 |
结账语言
结账页面支持 7 种语言，根据浏览器设置自动检测：
英语、中文、日语、韩语、德语、法语、西班牙语
两种结账方式
Waffo Pancake 支持两种结账方式 — 选择适合您业务场景的一种：
结账会话（API）
动态链接 — 通过 API 创建，支持自定义参数。
- 适合：自定义结账流程、动态定价、元数据
- 默认 45 分钟有效期（可通过 expiresInSeconds 参数配置，最长 7 天）
产品购买链接
每个产品都有一个永久购买链接：
https://checkout.waffo.ai/{store-slug}/{product-slug}
https://checkout.waffo.ai/{store-slug}/{product-slug}/test
结账会话（API）
对于高级用例，通过 API 创建结账会话：
POST /v1/actions/checkout/create-session
认证式与匿名结账
通过 API 创建会话时，您可以选择两种模式：
- 认证式：提供
buyerIdentity 将订单绑定到稳定标识符。预填结账表单，并启用购买后自助服务。
- 匿名：无需身份信息。买家手动填写详情。适用于共享链接和模板商店。
结账安全
产品购买链接
- 链接是永久且公开的 — 不嵌入敏感数据
- 消费者每次打开链接时在服务端创建新的结账会话
- 产品版本和定价在访问时实时解析
结账会话（API）
- 会话在创建时锁定产品版本和价格快照
- 会话包含加密签名，无法被篡改
- 会话默认 7 天后过期（可通过
expiresInSeconds 配置）
通过 API 创建的结账会话默认 7 天后过期。过期后消费者需要开始新的会话。
