云对接
适用于线下POS支付场景
该接口用于通过云端向 POS 设备发起支付或预授权指令。
在调用本接口前,请务必确认 POS 设备处于在线且可用状态,以确保指令能够成功下发并被正常处理。
[!TIP|style:flat]
通过POS机器发起的预授权交易效期有5天,超过5天预授权订单将自动过期。
集成概览
本节介绍云端系统与 POS 终端之间的核心交互方式及基础操作流程。
1. 设备查询
获取商户名下的 POS 设备列表及其状态信息(如在设备号、序列号等)。
在发起交易前,需先完成设备查询以确定目标终端。
2. 发起交易
通过云端向指定 POS 设备发送交易指令,以发起支付或预授权操作。
POS 终端将展示支付界面并引导用户完成交易。
3. 取消交易
向 POS 终端发送取消指令,用于终止当前进行中的交易。
该操作会关闭终端上的支付界面,使系统可以重新发起新的交易请求。
适用于交易尚未完成的场景。
4. 撤销交易
向 POS 终端发送撤销指令,用于撤销一笔已完成的交易。
POS 终端将向用户展示撤销结果。
适用于交易已完成但尚未清算的场景。
预授权流程
对于预授权后的相关操作(如金额调整及最终请款),强烈建议通过 API 接口完成,而非通过 POS 终端直接操作。
该方式可提升系统一致性、可控性及交易可追溯性。
可用接口如下:
退款与取消支付
关于退款(包括部分退款)处理及支付取消流程,请参考以下文档:
- 退款
- 其它 / 取消支付