4.10终端信息采集接口


接口地址:
生产地址:https://vsp.allinpay.com/cusapi/merchantapi/addterm
测试地址:https://syb-test.allinpay.com/vsppcusapi/merchantapi/addterm

请求参数:

参数 参数名称 取值 可空 最大长度 备注
orgid 机构号 平台分配的代理商/集团号 15 共享机构号参数时必填
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填12
termno 终端号 8位数字 8 商户下唯一
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 终端类型(device_type)填写为 02、03、04、05、06、08、09 或 10时,必须填写终端序列号。
operation 操作类型 本次操作标识,取值范围:00:新增;01:修改;02:注销;(注销时,仅需上送termno字段) 2 当操作类型为注销02时,termsn,termstate可为空
termstate 终端状态 取值范围:00:启用;01:注销;注:终端注销时非必填 2  
termaddress 终端地址

正确示例:上海市-上海市-浦东新区-五星路101号5楼

错误示例:上海市-上海市-浦东新区-上海市浦东新区五星路101号5楼

100 省-市-区-详细地址,详细地址长度控制在 30 个汉字以内注:取值范围可参考《省市区结构说明》注:终端注销时非必填
signtype 签名方式   8

RSA

SM2

sign 签名 详见安全规范 32  

响应参数:

字段ID 字段名称 取值 可空 最大长度 备注
retcode 返回码 SUCCESS/FAIL 8 SUCCESS表示报备受理成功
retmsg 返回码说明   100  

yinjr 2024年9月11日 15:20 收藏文档