Skip to content

托管收银台(H5/PC)

更新: 2026-09-18 状态: 已发布(生产可用性取决于商户签约产品与通道配置)

托管收银台由智收通展示订单摘要、拉起支付并轮询会话状态,适合希望减少前端开发量的场景。

接入流程

  1. 商户服务端调用 POST /open/v1/checkout-sessionssceneH5PC,并通过 paymentProductCodes 声明允许使用的支付产品。
  2. 将用户导向 /checkout/{sessionId}。SmartPay 按商户已开通能力、场景和环境展示支付方式,不向浏览器暴露内部渠道号或渠道商户号。
  3. 付款人选择支付方式后,托管页以不透明 optionId 提交选择;平台原子锁定路由并创建支付订单。重复选择同一方式不会重复下单,订单创建后不能改选。
  4. 页面按返回的 CheckoutAction 展示跳转或二维码,并每 2 秒查询状态;请求超时为 6 秒,连续失败后提供手动重试。
  5. 用户完成支付后,页面展示终态及返回商户入口。returnUrl 仅用于导航,不表示支付成功。
  6. 商户服务端以 GET /open/v1/checkout-sessions/{sessionId} 或 Webhook 确认最终结果。

收银台配置

商户工作台可管理品牌主题、支付方式排序、返回地址白名单和发布版本。返回地址必须为 HTTPS,并按“协议 + 域名 + 端口”与应用白名单精确匹配。运行时只读取已发布快照,不读取草稿。

安全与有效期

  • 会话失效时间以响应中的 expiresAt 为准;过期后需重新创建会话。
  • 请勿自行拼装或长期缓存收银台地址。
  • 收银台不采集银行卡号、网银密码或支付密码。
  • 回跳不携带支付凭证,不得用作成功依据。

智收通平台为技术服务商:不持有客户资金、不开立支付账户、不从事资金清算。