新增终端报备

提供新增终端报备功能

请求参数

  • 请求地址

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=”

}

接口调用示例

Demo参考