接口地址
生产环境：https://cus.allinpay.com/cusapi/merchantapi/term
测试环境：https://syb-test.allinpay.com/vsppcusapi/merchantapi/term
使用场景：
查询或者新增商户下面的终端列表
请求参数：
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
orgid |
代理商号 |
平台分配的代理商号 |
否 |
15 |
|
|
cusid |
商户号 |
审核通过分配的通联商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的机构APPID |
否 |
8 |
|
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
|
reqtype |
请求类型 |
query/add |
否 |
10 |
接口请求子类型 |
|
termlist |
终端信息列表 |
终端列表的json |
否 |
1000 |
当reqtype为query时可为空 |
|
signtype |
签名类型 |
|
|
|
RSA/SM2 |
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
响应参数：
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
SUCCESS-请求成功 |
|
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
|
trxstatus |
状态码 |
1000|1999 |
否 |
4 |
1000: 获取结果成功 1999:获取结果失败 |
|
|
orgid |
代理商号 |
|
否 |
15 |
与请求一致 |
|
|
cusid |
商户号 |
|
否 |
15 |
与请求一致 |
|
|
以下信息只有当retcode为SUCCESS时有返回 |
||||||
|
auditstatus |
状态码 |
|
|
|
状态码为00时，表示请求成功 |
|
|
errmsg |
错误描述 |
|
是 |
100 |
|
|
|
termlist |
终端信息列表json格式 |
|
是 |
1000 |
当reqtype为query时不为空 |
|
|
addterms |
新增生成终端号#号分隔 |
10000001#10000002 |
是 |
1000 |
当reqtype为add时不为空 |
|
其中终端信息
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
termcode |
终端编号 |
|
是 |
8 |
当reqtype为add时不用填；当reqtype为query时不为空 |
|
termnum |
门店终端数 |
|
是 |
1 |
当reqtype为add时不为空，单门店最大终端数:10 |
|
branchno |
所属门店 |
|
否 |
4 |
|
|
printnum |
打印联数 |
|
是 |
2 |
默认为：2 |
|
status |
终端状态 |
正常status=1/禁用status=0 |
否 |
|
|
|
rejecttrxcodes |
禁用交易类型 |
VSP002 消费撤销 VSP003 消费退货 VSP004 预授权 VSP005 预授权撤销 VSP006 预授权完成 VSP007 预授权完成撤销 VSP502 微信撤销 VSP503 微信退货 VSP512 支付宝撤销 VSP513 支付宝退货 VSP506 QQ钱包撤销 VSP507 QQ钱包退货 VSP552 银联扫码撤销 VSP553 银联扫码退货 VSP011 扫码预消费 VSP013 扫码预消费完成 VSP014 扫码预消费完成退货 |
是 |
100 |
填入示例：VSP002，VSP003，VSP005 |