> ## 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 收银台用来决定你的用户看到哪些支付方式、如何分组、以什么顺序展示的规则。

## 我可以控制支付方式的展示顺序吗？

可以。在商户 Portal 中，进入 **Cashier Customization → Cashier Ranking**。在那里你可以：

* **按国家**配置排序，可以在 MID 或 SubMID 级别进行。
* **拖拽**支付方式（以及同一类型下的子支付方式）来调整顺序，或使用**置顶**操作把某一项移到第一位。
* 保存前实时预览生成的收银台布局。
* 点击 **Reset to Default Setting** 移除所选国家的自定义配置，回退到平台默认排序。

列表只包含你生效协议下可用的支付方式。如果你从未对某个国家做过自定义，则应用平台默认排序。

## 新签约的支付方式会出现在哪里？

如果你已经自定义了排序，新开通的支付方式绝不会打乱你现有的顺序：

* 你配置过的项保持原有位置不变。
* 新支付方式按平台默认的相对顺序**追加到列表末尾**。
* 新的子支付方式（例如 eWallet 下新增的一个钱包）追加到其所属类型分组的末尾。

排序页面上没有可见的"新"标记，所以新签约的支付方式会悄无声息地出现在其分组的底部。如果顺序对你很重要，
签约新支付方式后请检查排序页面。如果你仍在使用默认配置，列表只是刷新，新支付方式出现在其默认位置。

## 为什么有些钱包要点"See more"才能看到？

当一个支付类型下的子支付方式超过三个时，收银台展示（按排序的）前三个，其余的折叠在 **See more (X more)** 按钮后面。
点击即可立即展开完整列表；**Show less** 则折叠回去。这让页面保持紧凑——你排在前面的支付方式获得曝光。
Portal 的实时预览中也应用同样的折叠规则。

## 为什么收银台上某个支付方式是灰色的？

当某个支付方式暂时不可用时（例如渠道或服务商维护期间），收银台**将其置灰而不是隐藏**：

* 置灰不改变已配置的排序，因此布局保持稳定。
* 如果某类型下的所有子支付方式都不可用，整个类型图标置灰且不可选择。
* 默认选中项自动落到第一个*可用*的支付方式上。

维护结束后可用性会自动恢复。

## 国家标签页是怎么组织的？为什么某个钱包出现在我没想到的国家下面？

收银台的标签页按**支付方式国家**分组——即支付方式本身所属的国家（本地钱包属于其所在国家；卡组织属于 Global）。
这个映射由平台定义，不能按商户更改。

* 支持全球的支付方式既出现在其所属国家的标签页下，也出现在 **Global** 标签页下。
* 只有当订单解析出两个或更多标签页时，才会显示标签页选择器。
* 默认标签页根据用户 IP 推断；如果没有匹配的标签页，则选中 Global 标签页，最后以字母顺序作为兜底。

## 我能针对某一笔订单缩小用户看到的范围吗？

部分可以，而且具体行为会让人意外。

创建订单时传入可选字段 `payMethodCountry`，收银台会隐藏属于其他国家的**本地**支付方式。
**全球可用的支付方式——卡组织及类似方式——始终保留**，因为它们不属于任何单一国家。所以传
`payMethodCountry=IDN` 并不会把页面缩减为只有印尼的支付方式；你仍然会看到全球性的那些。这是预期行为，不是 bug。

另外两个值得了解的效果：

* 如果你在所传国家下至少有一个本地支付方式，收银台不再显示国家标签页，而是呈现单一列表。
* 如果你在该国家下没有任何本地支付方式，支付方式保持各自的国家分组，因此标签页仍可能出现。

如果你签约的支付方式经过筛选后一个都不剩，订单创建会被拒绝，而不是展示一个空页面。

不传该字段，收银台展示你协议下的所有支付方式，并按上面所述分组到标签页中。

## 我能去掉国家标签页，或者把某个钱包从它的分组里单独拿出来吗？

对于有特殊布局需求的商户，还有两个展示选项：

* **平铺展示**——所有国家的所有支付方式在一个页面上展示，没有国家标签页。如果平铺后列表过长，收银台会对该订单
  自动回退到国家分组。
* **独立展示**——把单个支付方式从其类型分组中拿出来，作为独立的顶级项参与排序（卡类型不能被拿出来）。

两者默认都是关闭的。如果你希望为你的账户开启任一展示形式，请联系你的 Waffo 客户经理。

## 这个钱包只返回了一个收银台 URL——用户在收银台页面上要做什么？

并非每个支付方式都有 deeplink。若干东南亚钱包和二维码支付方式返回的是一个 **Waffo 收银台 URL**，真正授权支付的步骤
就发生在该页面上：

* **二维码支付方式**在 Waffo 收银台上渲染二维码。用户用自己的银行或钱包 App 扫码。
* **部分钱包**先在收银台页面收集用户手机号。用户提交后，钱包 App 向该用户的手机推送授权请求，用户在手机上批准。

两个对接上的影响：

* 你的 App 和 WebView 必须能打开收银台页面——如果你只处理 deeplink，这些支付方式会走进死胡同。
* 用户需要能够**扫描、保存或复制二维码**，所以不要把收银台渲染在会阻止长按或截图的容器里。

该读哪个 URL 字段（`webUrl` 还是 `deeplinkUrl`，由 `orderAction.actionType` 决定）见
[对接 FAQ](/docs/zh/developer-docs/tools-and-references/references/faq)。

## 我预期的某个支付方式完全没有出现在收银台上，怎么查原因？

缺失和置灰是不同的。置灰意味着暂时不可用——见上文。缺失意味着该支付方式根本没有进入该订单的列表。
按顺序逐项排查下面的列表；每一步都是你可以自己检查的：

| 检查项 | 方法 |
| - | - |
| 该支付方式在你的协议下**在当前环境中**是否生效？ | `POST /api/v1/paymethodconfig/inquiry`——sandbox 和 production 分别返回各自的结果 |
| 它是否支持订单的币种？ | 同一响应中列出了每个支付方式支持的币种 |
| 订单金额是否在该支付方式接受的范围内？ | 同一响应中带有金额范围——创建订单前先检查 |
| 是不是你自己把它过滤掉了？ | 订单上的 `payMethodType` / `payMethodName` / `payMethodCountry` 会缩小列表 |
| 它是否支持你传的终端？ | 不支持你的 `userInfo.userTerminal` 的支付方式不会被提供 |
| 它是否被折叠了？ | 某类型下子支付方式超过三个时，其余的都在 **See more** 后面 |

最常让人栽跟头的两项是金额范围和环境。金额刚好超出某支付方式的范围会悄悄把它移除而不是报错；在 production
上线的支付方式未必在测试环境中开通。

每项检查的具体机制见[支付方式配置与限额](/docs/zh/support/payment-method-config-and-limits-faq)。
如果该支付方式通过了全部六项检查却仍然不出现，请[联系支持](mailto:support@waffo.com)并附上订单 ID、金额、币种
以及你传的终端。

## 每次支付都一定会有跳转吗？我能去掉这一步吗？

不是，也不能。跳转次数是支付方式本身的属性，不是收银台额外加上的，也不是你能通过配置去掉的：

| 支付方式行为 | 顾客看到的跳转 |
| - | - |
| 卡 | 停留在收银台。发卡行可能插入一步认证 |
| 二维码 | 停留在收银台——二维码在此渲染，顾客用另一个 App 扫码 |
| 付款码和银行信息 | 停留在收银台——信息在此展示，顾客到其他地方付款 |
| 在自己界面上授权的钱包 | 跳出到钱包一次，然后返回 |
| 向顾客手机推送授权的钱包 | 不跳转——收银台收集一个标识符然后等待 |

所以只有当支付方式要求顾客在 Waffo 不控制的地方进行授权时，跳转才会存在。没有任何设置可以去掉它，自建页面也
去不掉——只不过变成由你接收跳转，而不是收银台替你处理。

你*能*去掉的是 Waffo 自己的选择页：在订单上固定支付方式，顾客就直接进入该支付方式的流程。如果你的账户开启了
绕过功能，你还可以去掉最后的 Waffo 结果页——见[收银台页面生命周期](/docs/zh/support/cashier-order-lifecycle-faq)。

## 金额明细显示什么？价格和税能分开列出吗？

已经是分开的。当订单带有相关数值时，收银台会逐项列出金额，而不是只显示一个总额：

| 行 | 何时出现 |
| - | - |
| Price | 订单金额，折扣前 |
| Discount | 订单应用了促销码或优惠券 |
| Subtotal | 跨币种订单时，显示为订单金额 → 顾客金额，下方附汇率 |
| Customer fee | 订单带有向顾客收取的费用 |
| Tax | 订单应税。该行以所适用税种自身的名称作为标签，所以顾客看到的是当地的称呼而不是"tax"这个词 |
| Total | 始终显示 |

两个值得了解的行为：

* 当顾客提供地址之后才能计算税额时，税额行会显示并提示输入地址，顾客填写后即解析出来——所以顾客在确认之前
  总能看到存在税费。
* 在订阅中，总额行读作今天应付的金额，对于试用或延迟开始的情况，这不等于周期性扣款金额。

以哪个币种为主展示以及金额的字号，属于客制化范围——见[客制化收银台页面](/docs/zh/support/cashier-customization-faq)。

## 我能更换支付方式图标或品牌名称，或者加自己的文字和链接吗？

不能。客制化范围只覆盖你自己的品牌元素——logo、商户名称、颜色、圆角、基础字号、头部布局和金额展示——仅此而已。
具体来说，没有以下控制项：

* 支付方式图标或品牌名称。它们由平台提供的素材渲染，以便顾客识别该支付方式，Portal 里也没有提供下载。如果你在
  自己的页面上需要某个品牌的标志，请从该品牌自己的品牌指南获取，其使用规则也在那里。
* 页面任何位置的自定义文字。
* 你自己的链接——支付指南、帮助中心或条款链接。

如果你的收银台需要在支付方式旁边放置商户撰写的文案或链接，途径是商户自建页面，而不是某项设置——见
[自建收银台页面](/docs/zh/support/merchant-built-checkout-faq)。

*可以*配置的完整清单见[客制化收银台页面](/docs/zh/support/cashier-customization-faq)。

## 默认排序是针对我所在市场的推荐吗？

它是**平台默认值**——你未对某个国家做自定义时应用的顺序。它不是根据你的流量得出的，不是按商户调优的，也不是
针对你所在市场的建议。把它当作一个合理的起点，而不是一个你不该轻易改动的推荐。

如果排序对你的业务很重要，有效的做法是对你关心的国家做自定义，并自己比较转化率；排序页面是按国家的，所以你可以
只改一个市场而不影响其他。至于在某个市场应优先展示哪些支付方式，请咨询你的 Waffo 联系人，而不要从默认顺序中
揣测意图。

## 国家切换器很容易被忽略，怎么让顾客直接看到正确的列表？

不要依赖顾客自己找到它。有两个办法可以减少这个问题，第一个比第二个有效得多：

* \*\*在订单上固定国家。\*\*如果你知道顾客在哪里——通过他们的账户、收货地址、所在的店面——就在 `/api/v1/order/create`
  上传 `payMethodCountry`。收银台随后呈现单一列表，没有需要寻找的标签页，同时卡组织等全球支付方式仍然可用。
  这也解决了顾客因为使用 VPN 或公司网络导致 IP 被解析到错误国家的情况。
* \*\*固定支付方式。\*\*如果你自己的页面已经问过顾客想用哪个支付方式，就传 `payMethodType` 和 `payMethodName`，
  顾客将完全跳过选择页。

参数行为，包括 `payMethodCountry` 会过滤什么、不会过滤什么，见上面的问题以及
[收银台自定义](/docs/zh/developer-docs/integration/checkout/customization#when-to-pass-paymethodcountry)。

## 如果我用本地币种定价，顾客还能用卡支付吗？

国家标签页按**支付方式的**国家分组，而不是按订单币种，所以用本地币种定价不会移除卡支付方式。卡组织是全球性的：
它们位于 Global 标签页下，无论顾客打开哪个本地标签页都在那里。顾客切换到本地标签页时看到的是该国的本地支付方式——
卡并没有消失，只是在旁边一个标签页里。

真正会让卡支付方式不可用的，是该币种本身没有在你的卡协议中开通。这在你创建订单之前就能看到：每个支付方式接受的
币种都列在 `paymethodconfig/inquiry` 的响应中——见[支付方式配置与限额](/docs/zh/support/payment-method-config-and-limits-faq)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.