收银台流程

​

收银台概览

​

两种收银台方式

​

产品购买链接

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

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

​

收银台会话（API）

POST /v1/actions/checkout/create-session

​

认证式与匿名收银台

• 认证式：提供 buyerIdentity 将订单绑定到稳定标识符。预填收银台表单，并启用购买后自助服务。
• 匿名：无需身份信息。买家手动填写详情。适用于共享链接和模板商店。

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

​

两步收银台流程

​

会话生命周期

• 一个会话，一笔订单。 一个 checkout session 只能生成一笔订单。买家提交后 session 即被消费，再打开同一个 checkoutUrl 会显示「结账链接已过期」。这是正常行为 —— 每次购买都重新调用 create-session，不要复用链接。
• 浏览器返回键。 跳转支付通道前，收银台会把当前历史条目替换成服务端由原会话派生出的新会话，支付通道的取消返回地址也指向同一个地址。所以两条返回路径都落到一个有效的会话上，你传的 orderMerchantExternalId 和 metadata 都保留 —— 与浏览器无关，因为这些值存在会话内容里。注意替换会话的有效期会重置为默认 45 分钟，即便你原来设了更长的 expiresInSeconds。
• 字段会丢的情况。 如果上述替换失败，或买家回到了一个已被消费的旧会话，页面会自愈：跳回商品页，以匿名访客身份重新铸一个全新会话。这条路径会丢掉 orderMerchantExternalId、metadata，以及你放在链接上的 currency、email、success_url。
• 订单上缺了这些字段怎么办。 如果收到 orderMerchantExternalId 为空的 order.completed，可在自己的系统里用 buyerEmail + productId + 金额，匹配该买家 30 分钟内的未支付订单。

​

第 1 步：消费者信息

​

必填字段

​

条件字段（基于国家）

​

企业购买选项

• 企业名称
• 完整账单地址
• 税号（可选，用于增值税豁免）

​

第 2 步：支付

​

支付方式

​

订单摘要

​

条款同意

• 服务条款
• 隐私政策
• 记录商声明

​

处理流程

1. 卡片验证 - Luhn 校验、有效期、CVC
2. 3D Secure - 银行验证（如需要）
3. 欺诈检查 - 风险评估
4. 授权 - 向卡片扣款
5. 订单创建 - 记录到系统

• 动画加载指示器
• “正在处理您的支付”提示
• 实时状态更新

​

结果页面

​

成功页面

• 订单确认号
• “收据已发送至您的邮箱”提示
• 后续步骤或访问说明
• 客户门户链接

​

失败页面

• 清晰的错误说明
• 建议操作
• 重试按钮
• 联系支持选项

​

订阅收银台

​

计费预览

​

试用信息（如已启用）

​

多语言支持

​

测试收银台

​

测试卡号

​

错误处理

​

常见支付错误

​

错误展示

• 清晰且可操作
• 非技术性语言
• 包含有用的后续步骤
• 不暴露敏感数据

​

收银台安全

​

产品购买链接

• 链接是永久且公开的 — 不嵌入敏感数据
• 客户每次打开链接时都会在服务端创建新的收银台会话
• 产品版本和定价在访问时实时解析

​

收银台会话（API）

• 会话在创建时锁定产品版本和价格快照
• 会话包含加密签名，无法被篡改
• 会话默认 45 分钟后过期（可通过 expiresInSeconds 配置，最长 7 天）

​

记录商声明

“This order is processed by our online reseller & Merchant of Record, Waffo Pancake, who also handles order-related inquiries and returns.”

​

后续步骤