简要描述:
通过该接口可完成自备机入网并绑定商户。
适用场景:1、服务商自采终端且未在海科绑定过商户,需联系运营获取“终端型号代码”,并在首次绑定时传入相应“终端型号代码” 2、服务商自采终端且已在海科完成入库或曾通过此接口绑定商户或通过海科采购的终端设备,通过此接口绑定时“终端型号代码非必填”
请求 URL:
请求参数(O-非必传 ,M-必传):
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
agent_no | 服务商编号 | String | M | ||
merch_no | 商户编号 | String | M | ||
storeId | 门店编号 | String | 涉及门店绑定终端时需要上传门店编号,默认门店则不需要上送 | O | |
agent_apply_no | 服务商申请单号 | String | O | ||
sn | 厂商sn编号 | String | 1、通过银联认证硬件终端必须上送tusn,未通过银联认证终端上送终端sn; 2、软件类或码牌需上送服务商系统内自定义生成的唯一标识; 3、最长不超过32个字符 |
88888888 | M |
code | 终端型号代码 | String | 若此sn已入库可不传此字段(首次绑定即完成入库) code枚举值参考下方常用终端型号代码 |
C | |
terminal_address | 终端布放地址 | String | 终端布放地址,省-市-区-详细地址, 详细地址长度控制在 60 个字符=30 个 汉字以内。 | 上海市-上海市-浦 东新区-五星路 | M |
请求示例:
{
"accessid": "ckrykj",
"agent_no": "11010200116",
"merch_no": "11010500003521",
"sn": "0917080000002311",
"code": "3456",
"terminal_address": "上海市-上海市-浦 东新区-五星路",
"agent_apply_no": "11010500003521",
"sign": "DA074B19207C4A00441D2197FBA6E826"
}
返回参数说明:
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
pn | 海科系统序列号 | String | 海科系统终端唯一标识 | 1601120100000222 | M |
返回示例:
{
"pn": "0917080000002311",
"return_code": 10000,
"sign": "FF332CD392EE8F5069DF4F8989C2842C"
}
常用终端型号代码:
- 若您的终端型号不在以下,请联系商务或运营并提供终端信息进行申请
名称 | code | 说明 |
---|---|---|
条码支付辅助受理终端 | 11 | 适用于服务商自有收银软件类、码牌、码枪等银联未认证的终端报备使用 |
联迪A8 | 1008 | 服务商联迪A8自备机入网使用 (自备机需自行安装附件中刷机程序) |
商米p2 | 1096 | 服务商商米P2自备机入网使用 |
商米p1 | 1083 | 服务商商米P1自备机入网使用 |
华智融NEW9220 | 1102 | 服务商华智融NEW9220自备机入网使用 |
服务商自备云音响(不含码牌) | 具体code请与产品或商务同事沟通确认,服务商自备不含码牌的云音响使用此参数入库绑定,含码牌的云音响一体机请联系商务协助入网(仅使用海科IOT平台云音响需使用此参数入库,使用服务商自有或其他iot平台终端使用条码支付辅助受理终端code值入库绑定即可) |
文档更新时间: 2025-01-02 15:19 作者:王金晶