2.18【终端信息管理】


测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle

生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle

接口代码(transCode):4001

 

功能说明:

(1)该接口用于维护终端信息,在付款码支付前需完成(收银宝付款码支付(CODEPAY_VSP/CODEPAY_VSP_ORG)维护。

(2)通过termno上送终端的自定义管理编号,保证商户号下唯一,且必须为8位数字。

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

orgId

String

15

收银宝集团商户号

集团模式:集团商户收银宝商户号

单商户模式:不填

cusId

String

15

收银宝商户号

单商户模式:商户收银宝商户号

集团模式:收银宝子商户号

termNo

String

8

终端号

8位数字

operation

String

2

操作类型

取值范围:

00:新增;

01:修改;

02:注销;

03:查询;

注:当“termStatusMsg -终端报备状态”为“受理成功”时不能“修改”和“注销”

deviceType

String

2

设备类型

10:条码支付受理终端(此类型终端为满足银联认证的厂商终端,且填写终端序列号);

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

仅当“操作类型”为“00:新增”、“01:修改”、“02:注销”,必填

termSn

String

50

终端序列号

仅当“操作类型”为“00-新增”、“01-修改”、“02-注销”且“设备类型”为“10”时,必填;

termState

String

2

终端状态

00:启用;

01:注销;

仅当“操作类型”为“00-新增”、“01-修改”,必填

termAddress

String

100

终端地址

仅当“操作类型”为“00-新增”、“01-修改”,必填;

省-市-区-详细地址,详细地址长度控制在 30 个汉字以内注:取值范围可参考《省市区结构说明》

queryType

String

3

查询类型

AT/UAT

1.空或者AT时仅返回AT报备状态

2.UAT的时候返回AT加银联报备状态

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

retCode

String

8

收银宝终端“新建、修改、注销、查询”结果

成功:OK

失败:error

retMsg

String

100

终端报备状态

受理成功

报备成功

orgId

String

15

收银宝集团商户号

仅操作类型为“03:查询”且为集团商户时,返回

cusId

String

15

收银宝商户号

单商户模式:商户收银宝商户号

集团模式:收银宝子商户号

仅操作类型为“03:查询”时,返回;

appid

String

8

收银宝应用号

仅操作类型为“03:查询”时,返回

termNo

String

8

终端号

仅操作类型为“03:查询”时,返回

deviceType

String

2

设备类型

仅操作类型为“03:查询”时,返回

termSn

String

50

终端序列号

仅操作类型为“03:查询”时,返回

termState

String

2

终端状态

仅操作类型为“03:查询”时,返回

termAddress

String

100

终端地址

仅操作类型为“03:查询”时,返回

errorCode

String

5

错误代码

仅当retCode=error时有值

透传渠道错误代码

errorMsg

String

100

错误信息

仅当retCode=error时有值

透传渠道错误信息

wxState

String

4

微信报备状态

0000:成功

0001:报备处理中

3999:失败

注:“operation-操作类型”为“03:查询”时返回;

wxMsg

String

100

微信报备信息

 

alState

String

4

支付宝报备状态

0000:报备成功

0001:报备处理中

3999:报备失败

注:“operation-操作类型”为“03:查询”时返回;

alMsg

String

100

支付宝报备信息

 

unState

String

4

银联报备状态

0000:报备成功

0001:报备处理中

3999:报备失败

注:“operation-操作类型”为“03:查询”时返回;

unMsg

String

100

银联报备信息

 

respCode

String

5

响应码

 

respMsg

String

200

响应信息

 

 


maxy2 2024年11月5日 15:22 收藏文档