使用场景
适用于由商家平台生成订单信息，通过智能POS完成支付的收单场景。
场景一:【云模式】商家系统可访问互联网，此场景下商户可通过云模式API将订单信息推送至搭载码钱收单的智能POS完成订单支付。
场景二:【本地模式】商家系统无法访问互联网或网络条件不良时，此场景下商户可将订单信息生成二维码，通过智能POS扫描订单二维码完成订单支付。
接入前置条件
1、【云模式】完成接入密钥配置（可前往商平台自行备案或联系渠道经理协助备案）
2、【云模式、本地模式】已采购搭载【码钱收单】应用的智能POS(联迪A8、新大陆N910、商米P2任意型号即可)
云模式
建议接入云模式时，同步适配本地模式，以保障公共网络不稳定等情况时的交易通畅。
业务流程
相关API
| 接口名称 | 接口地址 | 调试建议 |
|---|---|---|
| 订单支付下单请求 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/preOrderPay | 必选 |
| 正向交易结果异步通知 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/tradeNotify | 建议选择 |
| 交易查询 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/tradequery | 非必选 |
| 申请退款下单 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/refund | 非必选 |
| 退款订单查询 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/refundquery | 非必选 |
| 交易关闭 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/close | 非必选 |
| 退款交易结果异步通知 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/refundNotify | 非必选 |
本地模式
注：本地模式下使用手输订单号时无需技术对接
业务流程
相关API
| 接口名称 | 接口地址 | 调试建议 |
|---|---|---|
| 订单支付二维码规范 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/mqOpenAPI-1f8vg8qg5utdr | 必选 |
| 正向交易结果异步通知 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/tradeNotify | 建议选择 |
| 交易查询 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/tradequery | 非必选 |
| 申请退款下单 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/refund | 非必选 |
| 退款订单查询 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/refundquery | 非必选 |
| 交易关闭 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/close | 非必选 |
| 退款交易结果异步通知 | http://opendocs.hkrt.cn:8181/docs/mqOpenAPI/refundNotify | 非必选 |
文档更新时间: 2024-03-14 13:37 作者：梁博
