测试地址: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 |
是 |
响应信息 |