> ## 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.

# 收银台流程

> 消费者如何完成购买

## 两步收银台

消费者通过简洁的两步流程完成支付，优化转化率。

<Steps>
  <Step title="消费者信息" icon="user">
    收集邮箱、国家和账单信息，用于税费计算和订单处理。
  </Step>

  <Step title="支付" icon="credit-card">
    输入卡片信息或使用 Apple Pay / Google Pay 完成支付。
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/waffo/fAGQ8sa2qycWEk2d/images/checkout/checkout-step1.png?fit=max&auto=format&n=fAGQ8sa2qycWEk2d&q=85&s=e7454a2c64f08d42fe0fa1ac4084b712" alt="收银台页面 — 消费者信息" width="1440" height="900" data-path="images/checkout/checkout-step1.png" />
</Frame>

***

## 第 1 步：消费者信息

收集税费计算和订单处理所需的信息。

| 字段   | 必填 | 说明               |
| ---- | -- | ---------------- |
| 邮箱   | 是  | 用于收据、账户创建和客户门户访问 |
| 国家   | 是  | 用于税费计算           |
| 企业购买 | 否  | 勾选后显示企业名称和税号字段   |

点击 **Continue** 后进入支付步骤。

***

## 第 2 步：支付

消费者选择支付方式并完成付款。

<Frame>
  <img src="https://mintcdn.com/waffo/YbM_n4_eoBfrCsTT/images/checkout/checkout-step2.png?fit=max&auto=format&n=YbM_n4_eoBfrCsTT&q=85&s=e424a83d42c68d5946214be7f18cbbb7" alt="收银台页面 — 支付" width="1440" height="900" data-path="images/checkout/checkout-step2.png" />
</Frame>

### 支持的支付方式

<CardGroup cols={2}>
  <Card title="卡片支付" icon="credit-card">
    * Visa（信用卡 / 借记卡）
    * Mastercard（信用卡 / 借记卡）
    * 3D Secure 自动处理
  </Card>

  <Card title="数字钱包" icon="wallet">
    * Apple Pay（Safari / iOS）
    * Google Pay（Chrome / Android）
    * 一键完成，无需输入卡号
  </Card>
</CardGroup>

### 订单摘要

| 项目 | 说明            |
| -- | ------------- |
| 小计 | 产品价格          |
| 税费 | 根据消费者所在地区自动计算 |
| 总计 | 最终收费金额        |

***

## 订阅收银台

订阅产品的收银台页面会显示额外信息：

| 信息   | 说明            |
| ---- | ------------- |
| 计费周期 | 月付 / 季付 / 年付  |
| 首次收费 | 试用结束后的首次扣款日期  |
| 试用期  | 试用天数和结束日期（如有） |
| 自动续费 | 到期自动续费，可随时取消  |

***

## 税费处理

Waffo Pancake 自动计算并收取税费。

| 模式 | 行为              |
| -- | --------------- |
| 外加 | 税费单独显示，加到产品价格上  |
| 内含 | 价格已包含税费，显示为分解明细 |

税率根据消费者的账单地址自动确定，支持：

* **销售税**（美国）
* **增值税 VAT**（欧洲）
* **商品及服务税 GST**（澳大利亚、加拿大）

***

## 支付结果

### 成功

* 显示订单确认页面
* 发送确认邮件（含收据）
* 如设置了 `successUrl`，自动跳转

### 失败

* 显示错误原因和重试选项
* 常见原因：卡片被拒、余额不足、3D Secure 验证失败

| 错误     | 原因        | 消费者操作   |
| ------ | --------- | ------- |
| 卡片被拒   | 余额不足或银行拦截 | 尝试其他卡片  |
| 无效卡片   | 卡号错误      | 检查并重新输入 |
| 过期卡片   | 卡片已过期     | 使用有效卡片  |
| 3DS 失败 | 银行验证失败    | 联系银行    |

***

## 收银台语言

收银台页面支持 7 种语言，根据浏览器设置自动检测：

英语、中文、日语、韩语、德语、法语、西班牙语

***

## 两种收银台方式

Waffo Pancake 支持两种收银台方式 — 选择适合您业务场景的一种：

<CardGroup cols={2}>
  <Card title="产品购买链接" icon="link">
    **永久链接** — 永不过期，更新产品后仍然有效。

    * 适合：在网站、社交媒体、邮件中分享
    * 无需编写代码
  </Card>

  <Card title="收银台会话（API）" icon="code">
    **动态链接** — 通过 API 创建，支持自定义参数。

    * 适合：自定义收银台流程、动态定价、元数据
    * 默认 45 分钟有效期（可通过 expiresInSeconds 参数配置，最长 7 天）
  </Card>
</CardGroup>

### 产品购买链接

每个产品都有一个永久购买链接：

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

测试模式：

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

消费者打开链接时会自动创建收银台会话。只需在控制台点击"复制链接"即可。

### 收银台会话（API）

对于高级用例，通过 API 创建收银台会话：

```bash theme={"system"}
POST /v1/actions/checkout/create-session
```

### 认证式与匿名收银台

通过 API 创建会话时，您可以选择两种模式：

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

<Warning>
  当您了解买家身份时，强烈推荐认证式收银台。详见 [SDK 收银台模式](/zh/integrate/sdks#收银台模式)。
</Warning>

***

## 收银台安全

### 产品购买链接

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

### 收银台会话（API）

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

<Warning>
  通过 API 创建的收银台会话默认 7 天后过期。过期后消费者需要开始新的会话。
</Warning>