第三方接入

Version: V20170922

变更记录

1. 商务信息

1.1 购买入口

购买入口	说明
短信发送链接	发送购买链接给用户，用户点击链接进入购买页或者活动页
APP嵌入	在APP中制作入口（滚动图Banner、列表项、功能项），用户点击图片进入购买页或者活动页

1.2 渠道费率
确定渠道费率，当用户从购买入口进入提交订单,成功支付后进行承保，承保成功视为有效订单（承保率 98% 以上）
渠道佣金 = 有效订单车险全单费用 * 渠道费率

1.3 渠道费佣金结算方式

结算方式	说明
周结算	每周5日前 结算上周渠道佣金
月结算	每月10日前 结算上月渠道佣金

1.4 活动页面 引流入口
如果有活动页面，请提供给融石，方便融石在相关渠道推广
如果有引流方案，请提供给融石，方便在订单完成页的引流栏位中展示。

1.5 渠道入口地址
融石将提供入口地址，入口地址可以为多个（最多3个），方便流量区分，每一个入口可以制作多个字入口，可以给每一个销售一个相关入口

2. 流程演示
   http://s2i.rongstone.com/html/s2i/helperta.html

3. 接口说明

3.1 用户购买入口
http://s2i.rongstone.com/s2i/guide.html?参数

参数名	说明	是否非空	获得方式或示例
source	渠道来源	非空	商务中获得
backurl	用户点击返回的Url	非空	自行定义
seller	销售组	可空	自行定义
data	随路数据	可空	自行定义
plateno	车牌号	可空	粤WZB113
rackno	车辆识别代码（驾驶证上信息）	可空	LHGGM265992092167
engineno	车辆发动机号（驾驶证上信息）	可空	LW940622281
brandmodelname	车辆品牌型号（驾驶证上信息）	可空	别克SGM6510GL8旅行车
registdate	车辆注册日（驾驶证上信息）	可空	2004-08-18

3.2 用户报价完成回调
向融石 提供回调地址
http://XXXXX.XXX.XXX/XXX/XXX

名称	字段说明
timestamp	13位时间戳，需要判断接收到的时间戳 是否在当前时间的前后30分钟，如果不是，将按照无效请求处理
signature	String temp = MD5(globalno + "I" + token.upper() + "I" + timestamp)
globalno	全局流水号 : S2IXX2017032800001 固定位（S2I） + 业务名称（XX）+ 日期（20170328） + 最大10万（00001）
token	令牌，签名6-10位 数字字母

回调中 header 参数

名称	字段说明
timestamp	13位时间戳，需要判断接收到的时间戳 是否在当前时间的前后30分钟，如果不是，将按照无效请求处理
signature	String temp = MD5(globalno + "I" + token.upper() + "I" + timestamp)
globalno	全局流水号 : S2IXX2017032800001 固定位（S2I） + 业务名称（XX）+ 日期（20170328） + 最大10万（00001）
token	令牌，签名6-10位 数字字母

回调中 body

RequestBody:
{
    globalno: "XXXXXXXXXXXXX",      //全局流水号
    appno: "0703500136320170000648",//投保单号
    name: "张德智",                  //车主姓名
    plateno: "陕CC0969",            //车辆号牌（新车此字段为空）
    rackno: "LNBSCCAJ6DR327158",    //车辆识别代码
    engineno: "LW940622281",        //车辆发动机号
    brandmodelname: "别克SGM6510GL8旅行车",    //车辆品牌型号
    registdate: "2004-08-18",       //车辆注册日期
    citycode:"3440200",             // 车辆投保城市代码
    provincename:"广东省",           // 车辆投保城市名称
    cityname:"韶关市",               // 车辆投保城市名称
    businesspre: "3762.58",         //商业险费用
    jqxpre: "760.00",               //交强险费用
    vehicletax: "720.00",           //车船税费用
    sumpre: "5242.58"               //保险总费用
}

3.3 用户支付后回调
向融石 提供回调地址
http://XXXXX.XXX.XXX/XXX/XXX

回调中 header 参数
同上

回调中 body

RequestBody:
{
    globalno: "XXXXXXXXXXXXX",      //全局流水号
    appno: "0703500136320170000648",//投保单号
    consumesumpre: "5242.58",       //支付金额  此金额  <= 保险总费用
    result: "success",                  //支付结果  success  fault
}

3.4 用户承保后回调
向融石 提供回调地址
http://XXXXX.XXX.XXX/XXX/XXX

回调中 header 参数
同上

回调中 body

RequestBody:
{
    globalno: "XXXXXXXXXXXXX",      //全局流水号
    appno: "0703500136320170000648",//投保单号
    polno: "0703500136320170000648",//承保单号
    result: "success",                  //承保结果  success  fault
}

3.5 用户查看订单信息
http://s2i.rongstone.com/s2i/policyinfo.html?

参数名	说明
globalno	全局流水号
appno	投保单号

4. 接口调用
   回调接口执行完后必须打印输出“success”（不包含引号）。如果反馈给融石的字符不是success这7个字符，服务器会不断重发通知，直到超过8小时。一般情况下，25小时以内完成8次通知（通知的间隔频率一般是: 5s,1m,5m,10m,30m,1h,2h,4h）；