## 查询时长
付款码支付同步结果不是最终状态时，每隔3至5秒调用一次**[查询接口](https://open.shouqianba.com/docs/payment/71?category_id=54)**，总查询时间控制在40至50秒。
超过查询窗口仍未得到最终状态时：
- 保留原商户订单号和收钱吧订单号。
- 将订单标记为“结果未知”，提示收银员不要再次扫码扣款。
- 继续等待回调或转人工核实。
- 只有确认原交易最终失败后，才能创建新的支付。
## 付款码安全
付款码等同于顾客的短时支付凭证：
- 只允许从收银设备传到商户服务端。
- 不得记录在应用日志、埋点、监控截图或错误消息中。
- 不得长期存入数据库或展示在后台管理页面。
- 请求完成后及时清理前端和设备侧缓存。
## 退款异常查询
- 退款请求未返回最终状态时，前60秒每3秒查询一次；60秒后停止自动查询并转人工处理。
- 已明确返回退款处理中时，可以继续异步跟踪，最长5分钟；仍无最终状态时转人工核实。
- 原退款状态未明确失败前，不得重复退款或重新扣款。
## 真实公网IP
付款码支付请求中的顾客侧IP信息，应取当前收银机或POS设备的真实公网出口IP。不能固定填写服务器IP、`127.0.0.1`或随机构造地址。
如果门店通过统一出口上网，应由商户后台可信地获取并校验代理链路，避免客户端自行伪造。
## 防止重复扣款
- 商户订单号必须全局唯一。
- 接口超时只表示客户端没有取得结果，不表示扣款失败。
- 非最终结果始终查询原订单，不更换订单号重试付款码支付。
- 收银员再次点击支付前，应先检查原订单是否仍在处理中。
## 幂等履约
同步响应、主动查询和支付回调都可能先后报告同一个最终结果。商户系统应使用订单唯一约束和状态条件更新，确保出货、开闸、打印或发券只执行一次。
收钱吧开放平台