- 无论您接入的是单次代收、MIT 商户发起交易还是周期订阅,服务端均调用对应的下单接口。
- 下单接口同时返回
payUrl与clientToken两个关键字段——您只需根据前端呈现需求,选择使用payUrl跳转至 HaiPay 托管收银台(收银台模式 / Checkout Mode),或使用clientToken在自有页面内挂载组件(前置组件模式 / Component Mode)。
收银台模式(Checkout Mode)
使用响应中的
payUrl 将用户重定向至 HaiPay 托管页面完成付款。前端几乎零开发,最快完成验证与上线。前置组件模式(Component Mode)
使用响应中的
clientToken 将预构建的支付 UI 组件挂载到您自己的网页中,无需跳转即可实现最佳构建效率与转化体验。
前置组件模式(Component Mode)与收银台模式(Checkout Mode)架构与界面形态对比
核心对比与选型矩阵
参考行业通用的结账体验与合规分级标准,两种集成方式的核心差异如下:动态控制展示方式与顺序(paymentMethods vs inBankCode)
在调用银行卡代收(/usd/collect/apply)、MIT 申请(/usd/mit/apply)或订阅申请(/subscription/apply)接口时,您可以通过请求参数灵活控制向用户展示单个还是多个支付方式,以及它们的排列顺序:
规则提醒:
inBankCode与paymentMethods互斥二选一:当inBankCode不填时paymentMethods必填,反之亦然。paymentMethods的动态筛选与由上至下排序能力同样适用于 全球收银台(/global/cashier/collect/apply),便于在全球收银台中按业务偏好编排支付方式顺序。
如何选择?
- 何时选择「收银台模式(Checkout Mode)」
- 何时选择「前置组件模式(Component Mode)」
- 追求快速验证与上线:希望以最少的前端工作量在数小时内跑通支付闭环。
- 无独立前端页面或跨端分享:如在移动端 H5、邮件账单、社媒链接或轻量级应用中直接拉起支付。
- 零 UI 维护成本:希望由 HaiPay 全权负责支付页面的多端适配、安全隔离与交互细节。

