妙雀 318K 支付参数差异确认
结论:318K PDF 与此前 308 V2.4 文档在接口契约上未发现实质差异。PDF 文件名写 318K 和 V2,但正文首页与版本记录仍是 V2.4。
对重庆环卫方案影响:继续使用“我方消费系统生成二维码、设备只展示、自有消费系统扣款、设备轮询扣款结果、出货结果回传”的口径。
1. 核心参数对比
| 对比项 | 318K PDF | 308 V2.4 | 结论 |
|---|---|---|---|
| 正文版本 | V2.4 | V2.4 | 一致 |
weburlA | 获取第三方付款码 | 获取第三方付款码 | 一致 |
weburlA 入参 | ver, orderid, machid, trackno, name, price, channelid, randstr, timestamp, sign | 相同 | 无新增参数 |
weburlC 入参 | ver, orderid, torderid, machid, channelid, randstr, timestamp, sign | 相同 | 无新增参数 |
weburlB 入参 | ver, orderid, torderid, machid, trackno, status, errinfo, randstr, timestamp, sign | 相同 | 无新增参数 |
| 签名 | appkey + timestamp + randstr 排序拼接后 SHA1 | 相同 | 一致 |
| 状态码 | 0/1/2/3/4/5 | 相同 | 一致 |
| 业务流程 | 选商品、取二维码、查询结果、出货、上报 | 相同 | 一致 |
2. 非契约差异
| 差异 | 说明 | 影响 |
|---|---|---|
| 文件形态 | 318K 是 PDF,308 是 DOCX。 | 只影响归档和抽取方式。 |
| 设备型号 | 318K 只出现在文件名,正文未出现 318K 专属字段。 | 需厂家确认实机固件。 |
| 正文版本 | 文件名写 V2,正文写 V2.4。 | 按正文 V2.4 管理。 |
3. 需要厂家确认
| 问题 | 原因 |
|---|---|
318K 实机固件是否完全按 PDF 中 V2.4 的 weburlA/B/C 参数执行? | 不能只凭文件名承诺复用。 |
318K 的 machid/appkey、trackno 编号是否与 308 一致? | 影响设备台账和商品映射。 |
twocode 是否支持展示我方消费系统返回的任意 HTTPS URL 或二维码数据? | 重庆环卫方案要求二维码由我方生成,设备只展示。 |
出货失败 errinfo 是否有错误码表? | 影响冲正、退款、补贴返还和人工处理。 |