Appearance
托管收银台(H5/PC)
更新: 2026-09-18 状态: 已发布(生产可用性取决于商户签约产品与通道配置)
托管收银台由智收通展示订单摘要、拉起支付并轮询会话状态,适合希望减少前端开发量的场景。
接入流程
- 商户服务端调用
POST /open/v1/checkout-sessions,scene传H5或PC,并通过paymentProductCodes声明允许使用的支付产品。 - 将用户导向
/checkout/{sessionId}。SmartPay 按商户已开通能力、场景和环境展示支付方式,不向浏览器暴露内部渠道号或渠道商户号。 - 付款人选择支付方式后,托管页以不透明
optionId提交选择;平台原子锁定路由并创建支付订单。重复选择同一方式不会重复下单,订单创建后不能改选。 - 页面按返回的
CheckoutAction展示跳转或二维码,并每 2 秒查询状态;请求超时为 6 秒,连续失败后提供手动重试。 - 用户完成支付后,页面展示终态及返回商户入口。
returnUrl仅用于导航,不表示支付成功。 - 商户服务端以
GET /open/v1/checkout-sessions/{sessionId}或 Webhook 确认最终结果。
收银台配置
商户工作台可管理品牌主题、支付方式排序、返回地址白名单和发布版本。返回地址必须为 HTTPS,并按“协议 + 域名 + 端口”与应用白名单精确匹配。运行时只读取已发布快照,不读取草稿。
安全与有效期
- 会话失效时间以响应中的
expiresAt为准;过期后需重新创建会话。 - 请勿自行拼装或长期缓存收银台地址。
- 收银台不采集银行卡号、网银密码或支付密码。
- 回跳不携带支付凭证,不得用作成功依据。