新增终端报备¶
提供新增终端报备功能
请求参数¶
- 请求地址
https://spin.cloudpnr.com/ssproxy/addTerminalDevice
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ,请求报文体BODY - 「接口规则-参数规定-报文体」 ,响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
req_seq_id | 请求流水号 | String | Y | 32 | 请求流水号 |
req_date | 请求时间 | String | Y | 8 | 请求时间YYYYMMDD |
huifu_id | 汇付ID | String | Y | 18 | 汇付编号 |
product_id | 产品编号 | String | Y | 32 | 产品编号 |
terminal_info_list | 终端信息 | String | N | jsonArray格式 内容参考:terminal_info_list,不填默认辅助终端 |
- terminal_info_list
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
sn | 终端硬件序列号 | String | Y | 50 | 硬件序列号,见终端上 |
tusn | 终端21号文编号 | String | Y | 64 | 银联21号文编号,见终端上 |
dev_model_code | 终端型号代号 | String | Y | 16 | 见数据字典 |
terminal_address | 终端布放地址 | String | N | 64 | 报备使用的布放地址 |
响应参数¶
- 同步响应参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
sub_resp_code | 返回码 | String | Y | 8 | 业务返回码 |
sub_resp_desc | 返回描述 | String | Y | 512 | 业务返回描述 |
add_ter_info_list | 终端返回信息 | String | jsonArray格式 内容参考:add_ter_info_list |
- add_ter_info_list
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
huifu_id | 商户号 | String | Y | 18 | 商户huifuId |
device_id | 终端号 | String | Y | 21 | 终端号 |
bind_status | 绑定状态 | String | N | 2 | 绑定成功Y,绑定失败N |
terminal_seq_info | 终端报备信息 | String | N | jsonArray格式 内容参考:terminal_seq_info。一个终端会分别在AT做报备; 下面的列表展示已报备的记录 |
- terminal_seq_info
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
pay_way | 原入驻的支付通道 | String | Y | 1 | 入驻的支付通道, W:微信,A:支付宝 |
pay_scene | 场景类型 | String | Y | 2 | 1.线下反扫 2.线下公众号 3.线下小程序 4.线上公众号 5.线上小程序 6.缴费行业 7.校园餐饮(需要调商户活 动报名接口) 8.教育K12 9.非在线教培(需要调商户活动报名接口) 10.非盈利费率 11.保险费率 |
terminal_seq_id | 终端序列号 | String | N | 64 | 终端序列号,银联报备序列号。 |
请求示例¶
- {
- “sys_id”: “ssproxy_dev”, “data”: “{“req_seq_id”:”rQ202203174245393556256”,”req_date”:”20220317”,”huifu_id”:”6666000104558487”,”product_id”:”ZDTEST”,”terminal_info_list”:[{“sn”:”434333”,”tusn”:”J4544563”,”dev_model_code”:”01”,”terminal_address”:”上海额的发”}]}”, “sign”: “MqF6MteekUzjziiQ9isKHHbUfzgUbM/PIkOyYaooVob9WyJZwEacSOr+xxq4iW1hj60qpirW9uz4juVQDdH9GVmOgWKf/6EIiIaJmuVCufTK7BOORRRwNNM9ambp7m60OBcQAWixDSNp0juebGBzbDavvzH3VaCjX/aEz+ur/zs=”, “sign_type”: “RSA2”
}
响应示例¶
- {
- “data”: “{“add_ter_info_list”:[{“bind_status”:”Y”,”device_id”:”660035140101500308301”,”huifu_id”:”6666000104558487”,”terminal_seq_info_list”:[{“pay_scene”:”1”,”terminal_seq_id”:”HF0000wp”,”pay_way”:”A”}]},{“bind_status”:”Y”,”device_id”:”660035140101500308301”,”huifu_id”:”6666000104558487”,”terminal_seq_info_list”:[{“pay_scene”:”1”,”terminal_seq_id”:”HF0000wq”,”pay_way”:”W”},{“pay_scene”:”2”,”terminal_seq_id”:”HF0000wq”,”pay_way”:”W”},{“pay_scene”:”3”,”terminal_seq_id”:”HF0000wq”,”pay_way”:”W”}]}]}”, “resp_code”: “10000”, “resp_desc”: “成功调用”, “sign”: “ar8uu0KlI+ey7oohkGmSTjqm2mbKa4gDJjBX6ho8CDnlzEpnT0xcWL9dNWVx8NLNM548DV1ECBMFHXAFYRGQSa5Fwjg4qF8R0of3lFbCflj7Juv29byuf2grYAYwA821Iec7Ej2rCoUX6p4HUGRIhdb4pGjZpMya1JdUXS5aAlE=”
}