3.14终端信息查询


接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/cusapi/merchantapi/queryterm

测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/cusapi/merchantapi/queryterm

使用场景:终端信息采集结果查询。

请求参数

 

参数

参数名称

取值

可空

最大长度

备注

appid

应用ID

平台分配的APPID

20

 

orgid

机构ID

实际交易的机构ID

11

服务商appid调用时必填

cusid

商户号

实际交易的店铺ID

11

 

version

版本号

接口版本号

2

默认填12

termno

终端号

8位数字

8

商户下唯一

querytype

查询类型

AT/UAT

100

空或者AT时仅返回AT报备状态;UAT的时候返回AT加银联报备状态

signtype

签名方式

 

8

支持MD5、RSA、SM2,不填默认MD5

sign

签名

详见安全规范

32

 

响应参数

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

8

此字段是通信标识,非交易结果,交易是否成功需要根据返回的状态字段来判断

retmsg

返回码说明

 

100

 

以下信息只有当retcode为SUCCESS时有返回

cusid

商户号

实际交易的店铺ID

11

 

appid

应用ID

平台分配的APPID

20

 

sign

签名

 

32

详见安全规范

termno

终端号

8位数字

8

termno

devicetype

设备类型

01:自动柜员机(含 ATM 和 CDM)和多媒体自助终端

02:传统 POS

03:mPOS

04:智能 POS

05:II 型固定电话

06:云闪付终端;

07:保留使用;

08:手机 POS;

09:刷脸付终端;

10:条码支付受理终端;

11:条码支付辅助受理终端;

12:行业终端(公交、地铁用于指定行业的终端);

13:MIS 终端;

2

 

termsn

终端序列号

 

50

 

termstate

终端状态

00:启用、01:注销

2

 

termaddress

终端地址

上海市-上海市-浦东新区-五星路

100

 

wxstate

微信报备状态

 

4

0000:成功

0001:报备处理中

3999:失败

wxmsg

微信报备错误信息

 

100

 

alstate

支付宝报备状态

 

4

0000:成功

0001:报备处理中

3999:失败

almsg

支付宝报备错误信息

 

100

 

unstate

银联报备状态

 

4

0000:成功

0001:报备处理中

3999:失败

unmsg

银联报备错误信息

 

100

 

yststate

云商通商户及终端信息绑定状态

 

4

0000:成功

3999:失败


卜子超buzc 2025年5月14日 16:05 收藏文档