Skip to main content
本页说明 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。

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

缺失和置灰是不同的。置灰意味着暂时不可用——见上文。缺失意味着该支付方式根本没有进入该订单的列表。 按顺序逐项排查下面的列表;每一步都是你可以自己检查的: 最常让人栽跟头的两项是金额范围和环境。金额刚好超出某支付方式的范围会悄悄把它移除而不是报错;在 production 上线的支付方式未必在测试环境中开通。 每项检查的具体机制见支付方式配置与限额。 如果该支付方式通过了全部六项检查却仍然不出现,请联系支持并附上订单 ID、金额、币种 以及你传的终端。

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

不是,也不能。跳转次数是支付方式本身的属性,不是收银台额外加上的,也不是你能通过配置去掉的: 所以只有当支付方式要求顾客在 Waffo 不控制的地方进行授权时,跳转才会存在。没有任何设置可以去掉它,自建页面也 去不掉——只不过变成由你接收跳转,而不是收银台替你处理。 你能去掉的是 Waffo 自己的选择页:在订单上固定支付方式,顾客就直接进入该支付方式的流程。如果你的账户开启了 绕过功能,你还可以去掉最后的 Waffo 结果页——见收银台页面生命周期。

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

已经是分开的。当订单带有相关数值时,收银台会逐项列出金额,而不是只显示一个总额: 两个值得了解的行为:
  • 当顾客提供地址之后才能计算税额时,税额行会显示并提示输入地址,顾客填写后即解析出来——所以顾客在确认之前 总能看到存在税费。
  • 在订阅中,总额行读作今天应付的金额,对于试用或延迟开始的情况,这不等于周期性扣款金额。
以哪个币种为主展示以及金额的字号,属于客制化范围——见客制化收银台页面。

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

不能。客制化范围只覆盖你自己的品牌元素——logo、商户名称、颜色、圆角、基础字号、头部布局和金额展示——仅此而已。 具体来说,没有以下控制项:
  • 支付方式图标或品牌名称。它们由平台提供的素材渲染,以便顾客识别该支付方式,Portal 里也没有提供下载。如果你在 自己的页面上需要某个品牌的标志,请从该品牌自己的品牌指南获取,其使用规则也在那里。
  • 页面任何位置的自定义文字。
  • 你自己的链接——支付指南、帮助中心或条款链接。
如果你的收银台需要在支付方式旁边放置商户撰写的文案或链接,途径是商户自建页面,而不是某项设置——见 自建收银台页面。 可以配置的完整清单见客制化收银台页面。

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

它是平台默认值——你未对某个国家做自定义时应用的顺序。它不是根据你的流量得出的,不是按商户调优的,也不是 针对你所在市场的建议。把它当作一个合理的起点,而不是一个你不该轻易改动的推荐。 如果排序对你的业务很重要,有效的做法是对你关心的国家做自定义,并自己比较转化率;排序页面是按国家的,所以你可以 只改一个市场而不影响其他。至于在某个市场应优先展示哪些支付方式,请咨询你的 Waffo 联系人,而不要从默认顺序中 揣测意图。

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

不要依赖顾客自己找到它。有两个办法可以减少这个问题,第一个比第二个有效得多:
  • **在订单上固定国家。**如果你知道顾客在哪里——通过他们的账户、收货地址、所在的店面——就在 /api/v1/order/create 上传 payMethodCountry。收银台随后呈现单一列表,没有需要寻找的标签页,同时卡组织等全球支付方式仍然可用。 这也解决了顾客因为使用 VPN 或公司网络导致 IP 被解析到错误国家的情况。
  • **固定支付方式。**如果你自己的页面已经问过顾客想用哪个支付方式,就传 payMethodType 和 payMethodName, 顾客将完全跳过选择页。
参数行为,包括 payMethodCountry 会过滤什么、不会过滤什么,见上面的问题以及 收银台自定义。

如果我用本地币种定价,顾客还能用卡支付吗?

国家标签页按支付方式的国家分组,而不是按订单币种,所以用本地币种定价不会移除卡支付方式。卡组织是全球性的: 它们位于 Global 标签页下,无论顾客打开哪个本地标签页都在那里。顾客切换到本地标签页时看到的是该国的本地支付方式—— 卡并没有消失,只是在旁边一个标签页里。 真正会让卡支付方式不可用的,是该币种本身没有在你的卡协议中开通。这在你创建订单之前就能看到:每个支付方式接受的 币种都列在 paymethodconfig/inquiry 的响应中——见支付方式配置与限额。