在进行交易前,需要通过此接口进行终端信息报备,否则可能存在无法交易等情况。开通资金分账功能的机构店铺进行终端报备时,建议上送termSn和shopId字段,以自动完成商户信息与终端信息的相关绑定。若未上送shopId,则默认不做该绑定。
method: allinpay.shopoint.orderService.addTerm
version: 1.0
业务请求参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
mchtCd |
String |
否 |
15 |
商户号 |
|
termNo |
String |
是 |
8 |
终端号 |
8位数字,商户下唯一 |
deviceType |
String |
是 |
2 |
设备类型 |
01:自动柜员机(含 ATM 和 CDM)和多媒体自助终端 02:传统 POS 03:mPOS 04:智能 POS 05:II 型固定电话 06:云闪付终端; 07:保留使用; 08:手机 POS; 09:刷脸付终端; 10:条码支付受理终端; 11:条码支付辅助受理终端; 12:行业终端(公交、地铁用于指定行业的终端); 13:MIS 终端; |
termSn |
String |
否 |
50 |
终端序列号 |
终端类型(deviceType)填写为 02、03、04、05、06、08、09 或 10时,必须填写终端序列号。 |
operationType |
String |
是 |
2 |
操作类型 |
取值范围:00:新增;01:修改;02:注销;(注销时,仅需上送termNo字段) |
termState |
String |
是 |
2 |
终端状态 |
取值范围:00:启用;01:注销;注:终端注销时非必填 |
termAddress |
String |
是 |
100 |
终端地址 |
省-市-区-详细地址,详细地址长度控制在 30 个汉字以内。注:终端注销时非必填 |
shopId |
Integer |
否 |
11 |
店铺ID |
mchtCd与shopId不能同时为空,mchtCd为空时,shopId的店铺需要开通支付。 |
业务响应参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
code |
Integer |
是 |
4 |
返回码 |
0:表示报备受理成功; 3:表示失败,具体失败原因参见msg字段; 其他:参见4.1 公共返回码 |
msg |
String |
是 |
200 |
错误信息 |
|
请求示例
待补充
响应示例
待补充