> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 选择集成方案

> 对比 Waffo 两种收银台集成模式，选择合适的集成方案。

## 两种收银台模式

Waffo 支持两种收银台集成模式，商户根据自身需求选择：

* **Waffo 托管收银台（Checkout）**：Waffo 提供完整支付页面，用户在 Waffo 侧选择支付方式并完成支付
* **商户自建收银台（API 直连）**：商户自己构建支付页面，用户在商户侧选择支付方式，商户通过 API 参数指定支付通道

## 方案对比

| 维度         | Waffo Checkout    | 商户自建收银台             |
| ---------- | ----------------- | ------------------- |
| 支付方式选择     | 用户在 Waffo 收银台选择   | 用户在商户页面选择           |
| 集成复杂度      | 低（重定向即可）          | 高（自建 UI + 指定支付方式参数） |
| 支付方式覆盖     | 自动全覆盖，新增支付方式无需改代码 | 需自行维护支持列表           |
| PCI DSS 合规 | Waffo 负责          | 商户需自行处理（卡支付场景）      |
| UI 定制化     | 支持主题色、Logo、语言等    | 完全自定义               |
| 适用场景       | 大多数商户             | 有自建收银台的大型商户         |

## Waffo Checkout 传参方案

用户在 Waffo 侧选择支付方式，商户不需要传 `payMethodType` / `payMethodName`，Waffo 收银台自动展示所有可用支付方式。

完整的支付方式传参规则与示例，见 [收银台集成 - 自定义选项](/docs/zh/developer-docs/integration/checkout/customization)。

## 商户自建收银台传参方案

用户已在商户页面选择了具体支付方式，需要通过参数告诉 Waffo 走哪个通道。

<Note>
  **卡支付**：不需要传 `payMethodName`，传 `payMethodType` 即可。Waffo 通过卡号 BIN 自动识别 Visa / Mastercard / JCB / AMEX。

  **VA**：只传 `payMethodType: "VA"`，用户在 Waffo 侧选择具体银行。

  **电子钱包**：需传 `payMethodName` 指定具体钱包（如 DANA、GCash），目的是跳过 Waffo 收银台直达支付。Waffo 收银台本身支持所有支付方式的处理流程，传 `payMethodName` 是为了让用户直接进入指定钱包的支付流程。
</Note>

各支付方式的完整传参示例，见 [收银台集成 - 自定义选项](/docs/zh/developer-docs/integration/checkout/customization)。

## 嵌入方式

收到 `orderAction` 后，可通过重定向、iframe 嵌入或 App WebView 将用户引导到支付页面。各嵌入方式的适用场景与注意事项，参见 [Checkout 集成步骤](/docs/zh/developer-docs/integration/checkout/steps) 和 [支付方式集成注意事项](/docs/zh/developer-docs/tools-and-references/references/payment-method-integration-notes)。