接口地址：https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/cusapi/merchantapi/addterm
测试地址：https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/cusapi/merchantapi/addterm
使用场景：在进行交易前，需要通过此接口进行终端信息报备，否则可能存在无法交易等情况。开通资金分账功能的机构店铺进行终端报备时，建议上送termsn，以自动完成商户信息与终端信息的相关绑定。
请求参数
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
|
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
|
version |
版本号 |
接口版本号 |
是 |
2 |
默认填12 |
|
termno |
终端号 |
8位数字 |
否 |
8 |
商户下唯一 |
|
devicetype |
设备类型 |
01：自动柜员机（含 ATM 和 CDM） |
否 |
2 |
|
|
termsn |
终端序列号 |
|
是 |
50 |
终端类型（device_type）填写为 02、03、04、05、06、08、09 或 10时，必须填写终端序列号。 |
|
operation |
操作类型 |
本次操作标识，取值范围：00：新增；01：修改；02：注销；（注销时，仅需上送termno字段） |
否 |
2 |
当操作类型为注销02时，termsn，termstate可为空 |
|
termstate |
终端状态 |
取值范围：00：启用；01：注销；注：终端注销时非必填 |
否 |
2 |
|
|
termaddress |
终端地址 |
上海市-上海市-浦东新区-五星路 |
否 |
100 |
省-市-区-详细地址，详细地址长度控制在 30 个汉字以内注：取值范围可参考《省市区结构说明》注：终端注销时非必填 |
|
signtype |
签名方式 |
|
是 |
8 |
支持MD5、RSA、SM2，不填默认MD5 |
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
响应参数
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
SUCCESS表示报备受理成功 |
|
retmsg |
返回码说明 |
|
是 |
100 |