跳转至

终端新增或者注销接口

请求方式 body 编码 接口地址
POST application/json UTF-8 集测：https://mchapitest.shengpay.com/terminal/addOrCancelTerminal
生产：https://mchapi.shengpay.com/terminal/addOrCancelTerminal

请求参数

变量名 类型 必填 示例值 描述
mchId String Y 703525 商户号
subMchId String Y 703525 子商户号
operationType String Y 00 00-新增;02-注销
terminalInfo String Y 终端信息
deviceType String(2) Y 01 终端类型 (见终端类型)
serialNum String(50) N s/n023204902 终端序列号
deviceAddress String(30) Y 上海市浦东新区张衡路666弄 终端布放地址
nonceStr String Y 随机字符串
signType String Y RSA 签名类型
sign String Y 签名 (见签名介绍)

请求示例

1
2
3
4
5
6
7
8
9
{
    "mchId": "703525",
    "operationType": "00",
    "subMchId": "93762223",
    "terminalInfo": "{\"deviceAddress\":\"浦东新区张衡路666弄\",\"deviceType\":\"04\",\"serialNum\":\"S/N1028302180\"}"，
    "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时使用)
nonceStr String Y 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍

响应示例

1
2
3
4
5
6
7
8
9
{
  "resultCode": "SUCCESS",
  "errorCode": null,
  "errorCodeDes": null,
  "terminalInfo": "[{\"deviceType\":\"04\",\"deviceAddress\":\"浦东新区张衡路666弄\",\"zfbStatus\":\"ACCEPT\",\"serialNum\":\"S/N1028302180\",\"wxStatus\":\"ACCEPT\",\"unionStatus\":\"ACCEPT\",\"updateTime\":\"2022-02-21 08:45:00\"},{\"deviceType\":\"04\",\"deviceAddress\":\"浦东新区张衡路666弄\",\"zfbStatus\":\"ACCEPT\",\"serialNum\":\"S/N102830218011\",\"wxStatus\":\"ACCEPT\",\"unionStatus\":\"ACCEPT\",\"updateTime\":\"2022-02-22 08:40:57\"}]"，
  "sign": "ZHv4HxdAM5+cLhJFT12GtzkIiMzQBpBgrX7Oe2andBeHvnDqoLpOxzfpEML8FroxshGb+XfsjEvoj5O9WePEOjz3rwyNa2cA6unvBhOCvCiEuRjCto04L3LH+dHmCn/fpqTXQUzCEWMbpmzrikr/nDRiRg=",
  "signType": "RSA",
  "nonceStr": "QBfUbkggyLOBBNURbrBGOjBewwuMAqsy"
}
Back to top