跳转至

终端查询接口

请求方式 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 终端序列号
nonceStr String Y 随机字符串
signType String Y RSA 签名类型
sign String Y 签名 (见签名介绍)

请求示例

1
2
3
4
5
6
7
8
{
  "mchId": "93762223",
  "serialNum": "",
  "subMchId": "1022456155"，
  "nonceStr": "lsjdlfasldflasdl090",
  "signType ": "RSA",
  "sign": "SFLASJFDLAOSJDFOJO032042032987923928928JFLAJSLDFJALSUFOWIEU9R87W9"
}

响应参数

变量名 类型 必填 示例值 描述
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 终端类型 (见终端类型)
serialNum String(50) N s/n023204902 终端序列号
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 更新时间
nonceStr String Y 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍

响应示例

1
2
3
4
5
6
7
{
    "returnCode": "SUCCESS",
    "resultCode": "SUCCESS",
    "sign": "ZHv4HxdAM5+cLhJFT12GtzkIiMzQBpBgrX7Oe2andBeHvnDqoLpOxzfpEML8j1pqYxuU0DqC1fOXCFroxshGb+XfsjEvoj5O9WePEOjz3rwyNa2cA6unvBhOCvCiEuRjCto04L3LH+dHmCn/fpqTXQUzCEWMbpmzrikr/nDRiRg=",
    "signType": "RSA",
    "nonceStr": "QBfUbkggyLOBBNURbrBGOjBewwuMAqsy"
}
Back to top