扫码预授权公共参数说明
公共说明
接口文档中，必选栏目：M 必须，C 可选
| 说明 | 描述 |
|---|---|
| 接口版本 | v1.0.0 |
| 功能描述 | 外部机构接入开放平台 |
| 调用方 | 外部机构 |
| 请求方法 | POST |
| 请求签名 | 是 |
| 响应签名 | 是 |
| 需要BASE64编码 | 否 |
| 授权方式 | LKLAPI-SHA256withRSA |
| 测试环境URL | https://test.wsmsd.cn/sit/api/v2/labs/txn |
| 生产环境URL | https://s2.lakala.com/api/v2/labs/txn |
| 测试环境商户终端号 | 商户号：822290070111135 终端号： 29034705 商户号：822126090640003 终端号： 47781282 |
访问URL说明
| URL | 描述 |
|---|---|
| https://test.wsmsd.cn/sit/api/v2/labs/txn/preorder | 主扫支付 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/close | 关单 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/micropay | 被扫支付 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/revoked | 撤销 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/extOrderQuery | 外部订单查询 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/query | 交易订单查询 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/refund | 退款接口 |
| https://test.wsmsd.cn/sit/api/v2/labs/txn/dycodeCreate | 生成动态码 |
公共请求参数
| 字段 | 说明 | 是否必填 | 类型 | 备注 |
|---|---|---|---|---|
| timestamp | 时间戳 | C | Long | Unix时间戳。13位 |
| rnd | 随机数 | C | String(32) | 随机数 |
| ver | 版本号 | C | String(6) | 1.0.0 |
| reqId | 请求序列号 | C | String(32) | - |
| reqData | 请求参数 | M | Object | |
| locationInfo | 地址位置信息 | M | Object | |
| termExtInfo | 终端信息 | M | Object | 无特殊处理需求或无终端信息，填写”termExtInfo”:{} |
locationInfo字段说明
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| requestIp | 请求方IP地址 | M | String(64) | 请求方的IP地址，存在必填，格式如36.45.36.95 |
| baseStation | 基站信息 | C | String(128) | 客户端设备的基站信息（主扫时基站信息使用该字段） |
| location | 纬度,经度 | C | String(32) | 商户终端的地理位置，存在必填 格式：纬度,经度，+表示北纬、东经，-表示南纬、 西经，精度最长支持小数点后9位。举例:+37.123456789,-121.123456789 |
termExtInfo字段说明
| 属性 | 说明 | 必选 | 类型 | 备注 |
|---|---|---|---|---|
| termSN | 终端设备序列号 | C | String(64) | 商户终端设备的SN号，存在必填，如：QR930000001172 |
| termBaseStation | 终端基站信息 | C | String(128) | 商户终端设备的基站信息，存在必填，上送格式为：MNC 移动网络号码(2)＋LAC 位置区域码（5）+CID 基站编号（8）其中LAC不满五位，或CID不满足8位的均左补空格．如：00 6361 ·58130 为：00+LAC:6361+CID:58130 |
| termLoc | 终端地理位置 | C | String(100) | 商户终端的地理位置，存在必填 格式：纬度,经度，+表示北纬、东经，-表示南纬、 西经，精度最长支持小数点后9位。举例:+37.123456789,-121.123456789 |
| termIp | 终端IP地址 | C | String(32) | 商户终端的IP地址，存在必填，格式如36.45.36.95 |
| termSerialNo | 终端设备串号 | C | String(64) | 商户终端硬件的设备串号，存在必填，静态码没有 |
| termType | 终端设备类型 | C | String(2) | 商户终端硬件的设备类型，必填 01:PC 02:手机 03:收银机 04:移动终端 05:静态码 |
| termModel | 终端型号 | C | String(64) | 商户终端型号 |
| termManu | 终端厂商 | C | String(64) | 商户终端厂商 |
| appCode | 终端app代码 | C | String(64) | 商户终端app代码 |
| appVer | 终端app版本 | C | String(64) | 商户终端app版本 |
| termFP | 终端指纹 | C | String(64) | 商户终端指纹 |
termBaseStation、termLoc、termIp三者必须上送一个
公共响应参数
| 属性 | 说明 | 必选 | 类型 | 备注 |
|---|---|---|---|---|
| retCode | 返回业务代码 | M | String(8) | 返回业务代码(按照错误信息来定) |
| retMsg | 返回业务代码描述 | M | String(50) | 返回业务代码描述 |
| sign | 签名 | C | String(32) | 默认MD5方式签名，签名内容为retData+secret_key。 |
| timestamp | 时间戳 | M | Long | Unix时间戳，13位 |
| rnd | 随机数 | C | String(32) | 随机数 |
| reqId | 请求序列号 | C | String(32) | 请求序列号 |
| respId | 响应序列号 | C | String(32) | 响应序列号 |
| ver | 版本号 | M | String(6) | 版本号 |
| respData | 响应参数 | C | Object | 返回数据.下文定义的响应均为该属性中的内容 |
The End