跳转到主要内容
在 HaiPay 的支付体系中,「支付方式」(客户用什么付款,如银行卡、Apple Pay、Google Pay 或本地电子钱包)与 「收银台集成方式」(结账界面如何呈现在客户面前)是相互解耦的两个维度:
  • 无论您接入的是单次代收、MIT 商户发起交易还是周期订阅,服务端均调用对应的下单接口。
  • 下单接口同时返回 payUrl 与 clientToken 两个关键字段——您只需根据前端呈现需求,选择使用 payUrl 跳转至 HaiPay 托管收银台(收银台模式 / Checkout Mode),或使用 clientToken 在自有页面内挂载组件(前置组件模式 / Component Mode)。

收银台模式(Checkout Mode)

使用响应中的 payUrl 将用户重定向至 HaiPay 托管页面完成付款。前端几乎零开发,最快完成验证与上线。

前置组件模式(Component Mode)

使用响应中的 clientToken 将预构建的支付 UI 组件挂载到您自己的网页中,无需跳转即可实现最佳构建效率与转化体验。
前置组件模式与收银台模式对比图:使用组件模式以实现最佳优化构造,使用收银台模式进行快速验证

前置组件模式(Component Mode)与收银台模式(Checkout Mode)架构与界面形态对比

核心对比与选型矩阵

参考行业通用的结账体验与合规分级标准,两种集成方式的核心差异如下:
HaiPay 前置组件(Component)采用可扩展的容器架构设计。除了当前已支持的银行卡(支持信用卡与借记卡:VISA / MasterCard / JCB / AMEX / Diners / Discover)、Apple Pay 和 Google Pay 外,后续本地电子钱包及地区本地支付方式也将陆续接入前置组件体系。届时商户仅需签约开通或调整配置即可在组件内动态渲染新支付方式,无需重构前端收银台。

动态控制展示方式与顺序(paymentMethods vs inBankCode)

在调用银行卡代收(/usd/collect/apply)、MIT 申请(/usd/mit/apply)或订阅申请(/subscription/apply)接口时,您可以通过请求参数灵活控制向用户展示单个还是多个支付方式,以及它们的排列顺序:
规则提醒:
  1. inBankCode 与 paymentMethods 互斥二选一:当 inBankCode 不填时 paymentMethods 必填,反之亦然。
  2. paymentMethods 的动态筛选与由上至下排序能力同样适用于 全球收银台(/global/cashier/collect/apply),便于在全球收银台中按业务偏好编排支付方式顺序。

如何选择?

  • 追求快速验证与上线:希望以最少的前端工作量在数小时内跑通支付闭环。
  • 无独立前端页面或跨端分享:如在移动端 H5、邮件账单、社媒链接或轻量级应用中直接拉起支付。
  • 零 UI 维护成本:希望由 HaiPay 全权负责支付页面的多端适配、安全隔离与交互细节。
👉 查看 收银台模式接入指南

相关主题

最后修改于 2026年11月12日