终端查询接口
| 请求方式 | body | 编码 | 接口地址 |
|---|---|---|---|
| POST | application/json | UTF-8 | 集测:https://mchapitest.shengpay.com/terminal/queryTerminal 生产:https://mchapi.shengpay.com/terminal/queryTerminal |
请求参数
| 变量名 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| mchId | String | Y | 703525 | 商户号 |
| subMchId | String | Y | 703525 | 子商户号 |
| serialNum | String | N | s/n987989 | 终端序列号 |
| mchDeviceId | String | N | 商户终端号 | |
| nonceStr | String | Y | 随机字符串 | |
| signType | String | Y | RSA | 签名类型 |
| sign | String | Y | 签名 (见签名介绍) |
请求示例
1 2 3 4 5 6 7 8 9 | |
响应参数
| 变量名 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| returnCode | String | Y | SUCCESS | 返回码(SUCCESS/FAIL) |
| returnMsg | String | N | 返回消息(当returnCode为FAIL时使用) | |
| resultCode | String | Y | SUCCESS | 业务结果(SUCCESS/FAIL) |
| errorCode | String | N | 错误代码(当resultCode为FAIL时使用) 枚举类:(见错误码枚举类) | |
| errorCodeDes | String | N | 错误描述(当resultCode为FAIL时使用) | |
| terminalInfo | String | Y | [数组 | 终端信息 |
| deviceType | String(2) | N | 01 | 终端类型 (见终端类型) |
| deviceId | String(50) | N | 000234230 | 盛付通终端号-上传到两联的终端号 |
| serialNum | String(50) | N | s/n023204902 | 终端序列号 |
| mchDeviceId | String(50) | N | 商户终端号 | |
| deviceAddress | String(30) | N | 上海市浦东新区张衡路666弄 | 终端布放地址 |
| wxStatus | String(30) | N | VALID | 微信报备状态 VALID-有效;ACCEPT-已受理;CANCEL-已注销;FAIL-失败 |
| zfbStatus | String(30) | N | VALID | 支付宝报备状态 VALID-有效;ACCEPT-已受理;CANCEL-已注销;FAIL-失败 |
| unionStatus | String(30) | N | VALID | 银联报备状态 VALID-有效;ACCEPT-已受理;CANCEL-已注销;FAIL-失败 |
| updateTime | String(30) | N | yyyy-MM-dd HH:mm:ss | 更新时间 |
| failReason | String(64) | N | 失败原因 | |
| nonceStr | String | Y | 随机字符串 | |
| signType | String | Y | RSA | 签名方式 |
| sign | String | Y | 签名 (见签名介绍 |
响应示例
1 2 3 4 5 6 7 | |