线上支付
本栏目按业务场景组织，与接入方式无关：各页说明概念、操作流程与结果通知；涉及下单配置的场景还会对比收银台、Web SDK 与 API 直连的参数差异。各接入方式自身的接入流程见收银台接入、Web SDK 接入与 API 直连接入；通知的验签、应答与重试、幂等去重、状态判断与结果查询见 Webhook 通知。分账通知的地址、验签和应答方式见分账。
场景速查
| 场景 | 典型业务 | 收银台 | Web SDK | API 直连 |
|---|---|---|---|---|
| 保存支付方式 | 复购时不再重复输入卡信息 | 客户自选保存 | 客户自选保存 | 服务端绑卡、token 支付 |
| 订阅支付 | 按周期自动或由商户发起扣款 | 初始订阅 | 初始订阅 | 初始订阅、续费、升降级 |
| 预授权与请款 | 押金、预订、发货前锁定额度 | 预授权下单 | 预授权下单 | 预授权下单、请款、撤销 |
| 分账 | 平台模式下在支付后分配交易资金 | 下单时配置分账 | 下单时配置分账 | 下单时配置分账 |
支付成功后的退款由商户服务端通过 API 申请。退款指南说明申请、结果通知、查询与取消流程。
无论在哪种接入方式下单，自主管理订阅的续费、托管订阅的升降级、预授权的请款与撤销都由商户服务端通过 API 直连发起。
三类 token
文档中出现的三类 token 互不通用，接入前请先区分：
- 卡 token：客户自选保存或服务端绑卡后得到的
tokenId，用于后续 token 支付，见保存支付方式。 - 订阅 token：订阅扣款通知返回的
tokenId，与contractId配对用于订阅续费与升降级，见订阅支付。 - 钱包加密 token：Apple Pay、Google Pay SDK 返回的一次性加密报文，原样放入字段
tokenInfo的tokenId，并以provider指明钱包 token 提供方，由 Onerway 代解密；不能保存复用。
订阅并绑卡时会同时产生卡 token 与订阅 token，两套 token 属不同体系，不可混用。