• 公司介绍
  • 大数据中心
  • iPaaS(保险平台即服务)
  • 联系我们

公司简介


海豚保险

海豚保险经纪(深圳)有限公司于2016年4月在深圳成立,是中国保监会批准经营保险和风险管理业务的全国性保险经纪公司,同时具有互联网保险经营资质,注册资金为人民币5000万元。

资质牌照


“海豚保险网”是海豚保险经纪(深圳)有限公司开发并拥有的互联网保险平台,我们的网站经过中国保监会核准具有互联网保险销售资质。

互联网保险资质信息披露查询: http://www.iachina.cn/

查询路径:进入“中国保险行业协会”官网-信息披露-互联网保险信息披露-中介类信息披露-中介机构,找到海豚保险经纪(深圳)有限公司,点击进入查询即可。

海豚保险-营业执照 海豚保险-许可证

企业文化


  • 核心价值观

    A 1)坦诚、勤勉,快乐奋斗者;

    A 2)协作、坚韧,创新执行力。

    B 3)专注才能专业,自律才有自由。

    C 4)以用户为中心,善良比聪明更重要;

    C 5)以客户为中心,成就共赢共享价值!

  • 企业使命

    科技赋能,传递爱与责任,帮助用户精准识别风险,让家家户户都拥有适合自己的可靠保障!

  • 发展愿景和长期目标

    成为卓越领先且受人尊敬的风险管理与保险专家平台!

管理团队


海豚保险-管理团队

发展历程


海豚保险-发展历程

客户案例


海豚保险-客户案例 海豚保险-客户案例 海豚保险-客户案例

合作机构


海豚保险-合作伙伴

大数据中心


海豚保险-大数据中心

iPaaS


Insurance Platform-as-a-Service

iPaas(保险平台即服务)是打造以行业定制为特征,各企业组织为直接服务对象,线上线下互融的互联网保险服务平台。

  • 提供适合企业运营场景的性价比极致的保险产品

  • 对接超过100家全国性大型保险公司及其服务

  • 提供高速稳定的闭环的API接口

  • 将保险产品有机嵌入到企业运营流程,并提供风险数据分析服务

API接口


1.个险

  • 1.1引言

    • 1.1.1目的

      本文档编写的主要目的是描述海豚大数据对外提供个险保险产品的服务接口详细内容,以便于合作伙伴参考个险服务接口标准。内容主要包括输入参数、输出参数、参数类型、是否非空,相关备注等,接口对接交互、支付接口等公共内容需参考文档《海豚大数据接口规范说明书(公共)》。

    • 1.1.2访问地址

      测试环境

      http://testapi.htbaobao.com/htbb-interface/

  • 1.2业务流程类接口

    • 1.2.1投保接口

      该接口用于投保数据校验、提交。例如投保人信息、被保险人信息、保障日期,产品类型等。该接口调用成功之后,会返回执行状态、该产品的信息(可用于支付、查询)。

      请求参数

      参数代码 参数类型 非空 参数名称 备注
      user String Y 用户名
      sign String Y 签名 详见签名规则
      tradeId String Y 交易流水号 请保证每笔交易都是唯一的,该参数用于跟踪一笔唯一的交易,比如一笔交易的请求/响应超时等类似情况下,可使用相同tradeId值进行重复请求,实际只会执行一次(重复的请求会返回实际执行结果)
      custName String Y 投保人姓名
      custPhone String Y 投保人手机号码
      custSsn String Y 投保人身份证号
      custShip String N 投保人与被保险人关系 本人(默认),配偶,子女,父母,其他
      custEmail String N 投保人邮箱
      isuName String Y 被保人姓名
      isuSsn String Y 被保人证件号码
      isuIdType String Y 被保人证件类型 1-身份证2-护照3-其他
      isuAddress String N 被保人住址
      isuEmail String Y 被保险人邮箱
      isuDtStart String Y 起保日期 起保日期最小时间单位为当前时间半小时以后(一般为第二天起保)格式yyyy-MM-dd HH:mm:ss, 如 2016-5-21 18:00:00
      isuDtEnd String Y 止保日期 格式yyyy-MM-dd HH:mm:ss, 如 2016-5-21 18:00:00
      birthday String N 被保人出生日期 格式 yyyy-MM-dd
      jobType String N 职位类别 见附件《职业分类表2015》
      prodType String Y 购买产品类型 见附录-产品类型

      请求示例

      请求的json示例(加密前):
      		{
      		    "user": "user001",
      		    "sign": "96303720C6407BFAA7FC47A76AA481B1",
      		    "tradeId": "111000000002",
      		    "custName": "custNameAA",
      		    "custPhone": "13111111111",
      		    "custSsn": "430425199505051234",
      		    "custShip": "父子",
      		    "custEmail": "cust1@163.com",
      		    "isuName": "isunameAAA",
      		    "isuSsn": "430425195505052220",
      		    "isuIdType": "1",
      		    "isuAddress": "isuAddr..001",
      		    "isuEmail": "isu1@163.com",
      		    "isuDtStart": "2017-06-01 21:15:00",
      		    "isuDtEnd": "2017-06-08 21:15:00",
      		    "birthday": "2001-08-05",
      		    "jobType": "",
      		    "prodType": "TBYDB7"
      		}
      		

      接口路径

      测试环境地址:http://testapi.htbaobao.com/htbb-interface/personInsure/submitOrder

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model:
      参数代码 参数类型 非空 参数名称 备注
      status String Y 状态 0:待支付 1:投保提交成功,待出单
      money String Y 价格 单位为分
      hbCode String Y 核保单号

      返回结果示例

      解密后的内容:
      		{
      			" model ":{
      			   	"status":"0",
      				"money":500,
      				"hbCode":"1480496993654879"
      			},
      			"msg":"成功",
      			"msgCode":"success"
      		}
      		
    • 1.2.2支付接口

      支付说明

      目前海豚平台支持支付宝,微信,银联支付。支付后请保留支付流水号,以便查询流水和对账使用。参考《海豚收银台-接入文档》

    • 1.2.3退保接口

      目前只支持线下退保。

  • 1.3辅助查询类接口

    • 1.3.1获取投保信息查询接口

      请求参数

      参数代码 参数类型 非空 参数名称 备注
      user String Y 用户名
      sign String Y 加密签名 详见签名规则
      hbCode String 核保单号 三个参数传递其中一个,即可查询到保单信息(根据不同渠道业务合作模式)
      orderId String 订单号
      isuNum String 保单号

      请求示例

      请求的json示例(加密前):
      		{
      		    "user": "user0001",
      		    "sign": "xxx",
      		    "hbCode": "1495560970534542",
      		    "orderId": "",
      		    "isuNum": ""
      		}
      		

      接口路径

      测试环境地址:http://testapi.htbaobao.com/htbb-interface/personInsure/queryOrder

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model:
      orderStatus Integer Y 订单状态 见附录订单状态
      createDate String Y 下单日期
      epolicyNum String N 保单号 出单成功后才会有值,保险公司的保单号
      epolicPath String N 电子保单路径
      effectiveDate String Y 起保时间
      isuDtEnd String Y 止保时间
      orderPrice String Y 支付价格 单位为分
      prodName String Y 产品名称
      custEmail String Y 投保人邮箱
      custPhone String Y 投保人手机号码
      custName String Y 投保人姓名
      isuName String Y 被保人姓名
      isuSsn String Y 被保人身份证号码

      返回结果示例

      解密后的内容:
      		{
      		    "msgCode": "success",
      		    "msg": "",
      		    "model": {
      		        "custEmail": "enjoyfreedom@163.com",
      		        "isuName": "小明",
      		        "custPhone": "13456780001",
      		        "isuNum": "1498120323281600",
      		        "isuSsn": "120101198206060670",
      		        "orderStatus": "2",
      		        "isuDtEnd": "2017-06-25 18:06:00",
      		        "prodName": "运动宝【运动意外险】",
      		        "orderPrice": "1300",
      		        "custName": "小杰",
      		        "createDate": "2017-06-22 16:04:03",
      		        "effectiveDate": "2017-06-23 18:06:00",
      		        "epolicyNum": "111",
      		        "epolicPath": "http://www.htbaobao.com/dfj.pdf"
      		    }
      		}
      		
    • 1.3.2获取支付信息查询接口

      请求参数

      参数代码 参数类型 非空 参数名称 备注
      user String Y 用户名
      sign String Y 加密签名 详见签名规则
      payNo String 支付单号

      请求示例

      请求的json示例(加密前):
      		{
      		    "user": "user0001",
      		    "sign": "xxx",
      		    "payNo": "1495560970534542"
      		}
      		
      加密后:
      		7HouW+mO7QiP0CweyFDr0X/PnVPHWxOhVs2rrG1RK5Kl8RjusCAtAakI9Rw8k
      		RF+8KDlT9QrCS9HaJvMxIq1XnFXRWFXVe2Wl2m/98wOxCoPM6JfWm66a4ZWlE+vHIwu
      		

      接口路径

      测试环境地址:http://testapi.htbaobao.com/htbb-interface/personInsure/queryPay

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model:
      payStatus String Y 支付状态 0支付失败 1支付成功 2该支付单号不存在 3未支付
      orderNo String N 订单号
      price String N 支付单价

      返回结果示例

      解密后的内容:
      		{
      			"msg":"支付成功.",
      			"msgCode":"success",
      			"model":{
      				"payStatus":1,
      				"orderNo":"1480496993654879",
      				"price":"50"
      			}
      		}
      		
    • 1.3.3获取用户在该渠道下的所有订单接口

      请求参数

      参数代码 参数类型 非空 参数名称 备注
      user String Y 用户名
      sign String Y 加密签名 详见签名规则
      custPhone String Y 投保人手机号码

      请求示例

      请求的json示例(加密前):
      		{
      		    "user": "user0001",
      		    "sign": "xxx",
      		    "custPhone": "13122222222"
      		}
      		

      接口地址

      测试环境地址:http://testapi.htbaobao.com/htbb-interface/personInsure/queryPersonOrders

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Array Y 数组结果 数组
      model数组的元结构:
      参数代码 参数类型 非空 参数名称 备注
      orderTime String Y 下单时间
      orderAid String Y 订单编号
      orderPrice String Y 支付价格 单位为分
      prodName String Y 产品名称
      custEmail String Y 投保人邮箱
      custPhone String Y 投保人手机号码
      custName String Y 投保人姓名
      isuName String Y 被保人姓名
      isuSsn String Y 被保人身份证号码
      isuNum String Y 保单号/核保单号
      isuStatus String Y 订单状态
      isuDtStart String Y 起保时间
      isuDtEnd String Y 止保时间

      返回结果示例

      解密后的内容:
      	    {
      		    "msgCode": "success",
      		    "msg": "",
      		    "model": [
      		        {
      		            "orderAid": "14890503436659648",
      		            "orderTime": "2017-03-09 17:05:29",
      		            "orderPrice": "500",
      		            "prodName": "运动宝【运动意外险】",
      		            "isuEmail": "shinee_x_x@163.com",
      		            "custPhone": "13266886146",
      		            "custName": "XXX",
      		            "isuName": "XXX",
      		            "isuSsn": "362402XXXXXX11039",
      		            "isuNum": "ASHZ003E4C17PAAAAAAY",
      		            "isuStatus": "已终止",
      		            "isuDtStart": "2017-03-10 18:06:00",
      		            "isuDtEnd": "2017-03-11 18:06:00"
      		        },
      		        {
      		            "orderAid": "14890498722133174",
      		            "orderTime": "2017-03-09 16:04:37",
      		            "orderPrice": "500",
      		            "prodName": "运动宝【运动意外险】",
      		            "isuEmail": "shinee_x_x@163.com",
      		            "custPhone": "13266886146",
      		            "custName": "XXX",
      		            "isuName": "XXX",
      		            "isuSsn": "362402XXXXXX11039",
      		            "isuNum": "14890498722133185",
      		            "isuStatus": "已取消",
      		            "isuDtStart": "2017-03-10 18:06:00",
      		            "isuDtEnd": "2017-03-11 18:06:00"
      		        },
      		    ]
      		}
      		
  • 1.4附录

    • 1.4.1订单状态

      0 待支付

      1 待出单

      2 已出单

      3 已生效

      4 已终止

      8 已取消

      9 出单失败

      10 已退款

      11 理赔中

      12 不理赔

      13 已理赔

    • 1.4.2产品类型

      线上产品

      	TBYDB1运动宝1天
      	TBYDB3运动宝3天
      	TBYDB7运动宝7天
      
      	TBCWB7畅玩宝7天
      	TBCWB15畅玩宝15天
      	TBCWB30畅玩宝30天
      	TBCWB365畅玩宝365天
      
      	YAXYB_JJB 幸孕宝经济版
      	YAXYB_BZB 幸孕宝标准版
      	YAXYB_ZXB 幸孕宝尊享版
      	YAXYB_QJB 幸孕宝旗舰版
      
      	YAMMB30  咪咪宝30岁以下
      	YAMMB40  咪咪宝31-40岁
      	YAMMB50  咪咪宝41-50岁
      
      	YANSB30  女神宝30岁以下
      	YANSB40  女神宝31-40岁
      	YANSB50  女神宝41-50岁
      
      	护航宝 命名规则 :产品_保障天数(天)_保额(万)_是否附加险(Y是N否)
      	YAHHB1_100_Y      1天保障期 保额100万  有附加险
      	YAHHB365_100_Y
      	YAHHB1_200_Y
      	YAHHB365_200_N
      	YAHHB1_500_N
      	YAHHB365_500_Y
      	YAHHB1_200_Y
      	YAHHB365_200_Y
      
      	交通意外宝 命名规则 :产品_保障天数(天)
      	YAJTYWB1          1天保障期
      	YAJTYWB7
      	YAJTYWB30
      	YAJTYWB90
      	YAJTYWB365
      
      	账户安全宝 命名规则:产品_保障天数(天)_保障类型(标准版BZB、经济版JZB、
      	尊享版ZXB、旗舰版QJB)
      
      	RBZHAQB365_JZB    365天保障期 经济版
      	RBZHAQB365_BZB
      	RBZHAQB365_ZXB
      	RBZHAQB365_QJB
      	RBZHAQB90_JZB
      	RBZHAQB90_BZB
      	RBZHAQB90_ZXB
      	RBZHAQB90_QJB
      	RBZHAQB30_JZB
      	RBZHAQB30_BZB
      	RBZHAQB30_ZXB
      	RBZHAQB30_QJB
      
      	申根旅行宝 产品_保障天数(天)_保障类型(标准版BZB、
      	尊享版ZXB、旗舰版QJB)
      
      	ALSGLXB7_BZB      7天保障期 经典版
      	ALSGLXB15_BZB
      	ALSGLXB30_BZB
      	ALSGLXB90_BZB
      	ALSGLXB180_BZB
      	ALSGLXB365_BZB
      	ALSGLXB7_ZXB
      	ALSGLXB15_ZXB
      	ALSGLXB30_ZXB
      	ALSGLXB90_ZXB
      	ALSGLXB180_ZXB
      	ALSGLXB365_ZXB
      	ALSGLXB7_QJB
      	ALSGLXB15_QJB
      	ALSGLXB30_QJB
      	ALSGLXB90_QJB
      	ALSGLXB180_QJB
      	ALSGLXB365_QJB
      
      	环球旅行宝 产品_保障天数(天)_是否成年(Y是N否)_保障类型(经典版JDB、
      	标准版BZB、尊享版ZXB、旗舰版QJB)
      
      	ALHQLXB7_Y_JDB     7天保障期 成年 经典版
      	ALHQLXB15_Y_JDB
      	ALHQLXB30_Y_JDB
      	ALHQLXB90_Y_JDB
      	ALHQLXB180_Y_JDB
      	ALHQLXB365_Y_JDB
      	ALHQLXB7_N_JDB
      	ALHQLXB15_N_JDB
      	ALHQLXB30_N_JDB
      	ALHQLXB90_N_JDB
      	ALHQLXB180_N_JDB
      	ALHQLXB365_N_JDB
      
      	ALHQLXB7_Y_BZB
      	ALHQLXB15_Y_BZB
      	ALHQLXB30_Y_BZB
      	ALHQLXB90_Y_BZB
      	ALHQLXB180_Y_BZB
      	ALHQLXB365_Y_BZB
      	ALHQLXB7_N_BZB
      	ALHQLXB15_N_BZB
      	ALHQLXB30_N_BZB
      	ALHQLXB90_N_BZB
      	ALHQLXB180_N_BZB
      	ALHQLXB365_N_BZB
      	ALHQLXB7_Y_ZXB
      	ALHQLXB15_Y_ZXB
      	ALHQLXB30_Y_ZXB
      	ALHQLXB90_Y_ZXB
      	ALHQLXB180_Y_ZXB
      	ALHQLXB365_Y_ZXB
      	ALHQLXB7_N_ZXB
      	ALHQLXB15_N_ZXB
      	ALHQLXB30_N_ZXB
      	ALHQLXB90_N_ZXB
      	ALHQLXB180_N_ZXB
      	ALHQLXB365_N_ZXB
      	ALHQLXB7_Y_QJB
      	ALHQLXB15_Y_QJB
      	ALHQLXB30_Y_QJB
      	ALHQLXB90_Y_QJB
      	ALHQLXB180_Y_QJB
      	ALHQLXB365_Y_QJB
      	ALHQLXB7_N_QJB
      	ALHQLXB15_N_QJB
      	ALHQLXB30_N_QJB
      	ALHQLXB90_N_QJB
      	ALHQLXB180_N_QJB
      	ALHQLXB365_N_QJB
      
      	臻爱医疗宝 产品_保障年龄 年)_是否有社保(Y是N否)_保障类型(标准版BZB、
      	尊享版ZXB、旗舰版QJB)
      
      	ALZAYL5_Y_BZB        0-5岁有社保标准版
      	ALZAYL10_Y_BZB
      	ALZAYL15_Y_BZB
      	ALZAYL20_Y_BZB
      	ALZAYL25_Y_BZB
      	ALZAYL30_Y_BZB
      	ALZAYL35_Y_BZB
      	ALZAYL40_Y_BZB
      	ALZAYL45_Y_BZB
      	ALZAYL50_Y_BZB
      	ALZAYL55_Y_BZB
      	ALZAYL60_Y_BZB
      
      	ALZAYL5_N_BZB        0-5岁无社保标准版
      	ALZAYL10_N_BZB
      	ALZAYL15_N_BZB
      	ALZAYL20_N_BZB
      	ALZAYL25_N_BZB
      	ALZAYL30_N_BZB
      	ALZAYL35_N_BZB
      	ALZAYL40_N_BZB
      	ALZAYL45_N_BZB
      	ALZAYL50_N_BZB
      	ALZAYL55_N_BZB
      	ALZAYL60_N_BZB
      
      	ALZAYL5_Y_ZXB        0-5岁有社保尊享版
      	ALZAYL10_Y_ZXB
      	ALZAYL15_Y_ZXB
      	ALZAYL20_Y_ZXB
      	ALZAYL25_Y_ZXB
      	ALZAYL30_Y_ZXB
      	ALZAYL35_Y_ZXB
      	ALZAYL40_Y_ZXB
      	ALZAYL45_Y_ZXB
      	ALZAYL50_Y_ZXB
      	ALZAYL55_Y_ZXB
      	ALZAYL60_Y_ZXB
      
      	ALZAYL5_N_ZXB        0-5岁无社保尊享版
      	ALZAYL10_N_ZXB
      	ALZAYL15_N_ZXB
      	ALZAYL20_N_ZXB
      	ALZAYL25_N_ZXB
      	ALZAYL30_N_ZXB
      	ALZAYL35_N_ZXB
      	ALZAYL40_N_ZXB
      	ALZAYL45_N_ZXB
      	ALZAYL50_N_ZXB
      	ALZAYL55_N_ZXB
      	ALZAYL60_N_ZXB
      
      	ALZAYL5_Y_QJB        0-5岁有社保旗舰版
      	ALZAYL10_Y_QJB
      	ALZAYL15_Y_QJB
      	ALZAYL20_Y_QJB
      	ALZAYL25_Y_QJB
      	ALZAYL30_Y_QJB
      	ALZAYL35_Y_QJB
      	ALZAYL40_Y_QJB
      	ALZAYL45_Y_QJB
      	ALZAYL50_Y_QJB
      	ALZAYL55_Y_QJB
      	ALZAYL60_Y_QJB
      
      	ALZAYL5_N_QJB        0-5岁无社保旗舰版
      	ALZAYL10_N_QJB
      	ALZAYL15_N_QJB
      	ALZAYL20_N_QJB
      	ALZAYL25_N_QJB
      	ALZAYL30_N_QJB
      	ALZAYL35_N_QJB
      	ALZAYL40_N_QJB
      	ALZAYL45_N_QJB
      	ALZAYL50_N_QJB
      	ALZAYL55_N_QJB
      	ALZAYL60_N_QJB
      
      	成人重疾宝 产品_保障年龄 年)_是否有社保(Y是N否)_保障类型(标准版BZB、
      	至尊版ZJB、旗舰版QJB)
      
      	TKZYJ25_BZB        18-25岁标准版
      	TKZYJ30_BZB        26-30岁标准版
      	TKZYJ35_BZB        31-35岁标准版
      	TKZYJ40_BZB        36-40岁标准版
      	TKZYJ45_BZB        41-45岁标准版
      	TKZYJ50_BZB        46-50岁标准版
      
      	TKZYJ25_ZJB        18-25岁至尊版
      	TKZYJ30_ZJB        26-30岁至尊版
      	TKZYJ35_ZJB        31-35岁至尊版
      	TKZYJ40_ZJB        36-40岁至尊版
      	TKZYJ45_ZJB        41-45岁至尊版
      	TKZYJ50_ZJB        46-50岁至尊版
      
      	TKZYJ25_QJB        18-25岁旗舰版
      	TKZYJ30_QJB        26-30岁旗舰版
      	TKZYJ35_QJB        31-35岁旗舰版
      	TKZYJ40_QJB        36-40岁旗舰版
      	TKZYJ45_QJB        41-45岁旗舰版
      	TKZYJ50_QJB        46-50岁旗舰版
      	

      线下产品

      	少儿健康宝 产品_保障类型(经济版JJB、标准版BZB、尊享版	ZXB)
      	SRJKB_JJB        经济版
      	SRJKB_BZB
      	SRJKB_ZXB
      
      	海豚淘气宝 产品_保障类型(经济版JJB、标准版BZB、尊享版	ZXB、旗舰版QJB)
      	HTTQB_JJB        经济版
      	HTTQB_BZB
      	HTTQB_ZXB
      	HTTQB_QJB
      
      	牵手宝
      	QSB_DSB       单身版
      	QSB_ZXB		恋爱版
      	QSB_QJB		旗舰版
      
      	成人意外宝 产品_保障天数(天)_保障类型(标准版BZB、尊享版ZXB、旗舰版QJB)
      	CRYWB1_BZB      1天标准版
      	CRYWB7_BZB
      	CRYWB15_BZB
      	CRYWB30_BZB
      	CRYWB180_BZB
      	CRYWB365_BZB
      
      	CRYWB1_ZXB      1天尊享版
      	CRYWB7_ZXB
      	CRYWB15_ZXB
      	CRYWB30_ZXB
      	CRYWB180_ZXB
      	CRYWB365_ZXB
      
      	CRYWB1_QJB      1天旗舰版
      	CRYWB7_QJB
      	CRYWB15_QJB
      	CRYWB30_QJB
      	CRYWB180_QJB
      	CRYWB365_QJB
      
      	炸机宝
      	ZJB_BZB      标准版
      	ZJB_BZB      尊享版
      
      	安居宝
      	AJB_BZB      标准版
      	AJB_ZXB      尊享版
      	AJB_QJB	   旗舰版
      	

2.车险

  • 2.1引言

    • 2.1.1目的

      本文档编写的主要目的是描述海豚大数据对外提供车险保险产品的服务接口详细内容,以便于合作伙伴参考车险服务接口标准。内容主要包括输入参数、输出参数、参数类型、是否非空,相关备注等,接口对接交互等公共内容需参考文档《海豚大数据接口规范说明书(公共-重构)V1.8》。

    • 2.1.2访问地址

      测试环境

      http://testapi.htbaobao.com/htbb-interface/

    • 2.1.3交互流程

  • 2.2主流程接口

    • 2.2.1车型列表查询接口

      通过车辆型号等信息查询出车型列表信息

      请求参数

      参数名 含义 格式 是否必填 说明
      vendorType 保险公司类型 String 见附录
      carModel 车辆型号 String 车辆行驶证的品牌型号
      licensePlateNo 车牌号码 String 车辆行驶证的车牌号码,如果新车未上牌,不传
      vin 车辆识别码 String 车辆行驶证的识别码或者新车车架号
      engineNo 发动机号 String 车辆行驶证的发动机号
      city 投保城市 String 投保车险的城市编码
      firstRegisterDate 车辆注册日期 String 车辆的注册/登记日期yyyy-mm-dd
      isLicense 是否上牌标志 String 车辆是否上牌的标志,0 否 1是
      pageNo 指定取结果列表页码 String 默认第1页
      pageSize 每页数量 String 默认10条

      请求示例

      加密前明文:
      {
          "sign": "6E091F8627B761C682BEF9E3CDC02580",
          "licensePlateNo": "沪B2E816",
          "engineNo": "DA***30",
          "carModel": "CAF7201B4",
          "pageNo": 1,
          "firstRegisterDate": "2013-07-25",
          "vin": "LV*************83",
          "isLicense": 1,
          "pageSize": 25,
          "vendorType": 4,
          "city": "440300"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/getCarType

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      totalCount String Y 总数量
      serialNum String Y 交互流水号 用于跟踪一次报价/投保交互流程,后续操作接口需要传入该流水号
      vehicleDtoList List Y 车型列表
      vehicleDtoList列表如下:
      参数代码 参数类型 非空 参数名称 备注
      modelCode String Y 车型代码
      modelName String Y 车型名称
      modelDesc String Y 车型描述
      brandName String Y 车型描述
      marketYear String Y 上市年份(年款)
      replacementValue String Y 新车购置价
      model String Y 车辆型号
      displaceMent String Y 排量
      factory String Y 生产厂家
      derailleurType String Y 变速器方式
      ratedPassengerCapacity String Y 额定载客人数
      series String Y 车系名称

      返回结果示例

      解密后内容
      {
          "serialNum": "20171107152914856588",
          "totalCount": "3",
          "vehicleDtoList": [
              {
                  "brandName": "长安福特",
                  "derailleurType": "手自一体",
                  "displaceMent": "1.999",
                  "model": "福克斯CAF7201B48轿车",
                  "modelCode": "vCXdRuSAbCYRhRCR7tcUmA==",
                  "modelDesc": "2009款 运动型",
                  "ratedPassengerCapacity": "5",
                  "replacementValue": "137900",
                  "series": "福克斯"
              },
              {
                  "brandName": "长安福特",
                  "derailleurType": "手自一体",
                  "displaceMent": "1.999",
                  "model": "福克斯CAF7201B48轿车",
                  "modelCode": "vCXdRuSAbCal/4ldXFyokQ==",
                  "modelDesc": "2011款 运动型",
                  "ratedPassengerCapacity": "5",
                  "replacementValue": "136800",
                  "series": "福克斯"
              },
              {
                  "brandName": "长安福特",
                  "derailleurType": "双离合变速器",
                  "displaceMent": "1.999",
                  "model": "福克斯CAF7201B4轿车",
                  "modelCode": "vCXdRuSAbCbx1i4Z3koALw==",
                  "modelDesc": "2012款 豪华运动型",
                  "ratedPassengerCapacity": "5",
                  "replacementValue": "138900",
                  "series": "福克斯"
              }
          ],
          "vendorType": 4
      }
      																
    • 2.2.2询价申请接口

      用户从2.2.1返回的列表中选择自己的车型后,填写车主信息等进行询价申请,返回推荐的交强险/商业险起保日期

      使用限制

      必须先调用车型列表查询接口获取交互流水号

      请求参数

      参数名 含义 格式 是否必填 说明
      vendorType 保险公司类型 String 见附录
      serialNum 流水号 String 2.2.1接口车型列表查询接口返回
      modelCode 车型代码 String 选择第一步结果列表中的车型代码
      carOwner 车辆拥有者 String 车辆行驶证的姓名
      ownerIdNum 车主身份证号 String 车主身份证号码
      phone 车主电话 String 车主电话
      isTransfer 是否过户车 String 1:过户0:非过户
      transferDate 过户日期 String 如果车是辆过户车,则需传过户日期
      isSame 被保人是否和车主一样 String 0代表一样1代表不一样
      isuName 被保险人姓名 String 如果和车主不一样,被保险人姓名必填
      isuIdNum 被保人身份证号 String 如果和车主不一样,被保人身份证号必填
      loanCarFlag 贷款车标志 String 众安贷款车时,传1
      lendOrg 贷款机构 String 众安贷款车时,必传,2.4.5查询贷款机构接口
      lendSubOrg 贷款子机构 String 众安贷款车时,必传
      invoiceNo 新车购置发票号 String 众安:北京、上海地区未上牌新车必传,销售发票编号
      invoiceDate 发票开具日期 String 众安:北京、上海地区未上牌新车必传,销售发票所载日期,格式YYYY-MM-dd
      custName 投保人姓名 String 投保人姓名
      custPhone 投保人手机号码 String 投保人手机号码
      custIdNum 投保人身份证号 String 投保人身份证号

      请求示例

      加密前明文:
      {
          "sign": "77ADBBFDF7B070555C90153ECF5F4E84",
          "isTransfer": "0",
          "phone": "13688883333",
          "isSame": "1",
          "transferDate": "",
          "modelCode": "vCXdRuSAbCYRhRCR7tcUmA==",
          "carOwner": "汪大伟",
          "vendorType": 4,
          "ownerIdNum": "150522199304011411",
          "serialNum": "20171107152914856588"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/applyQuotePrice

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      importFlag String Y 进口车标志 A-进口,B-国产
      serialNum String Y 交互流水号 车型列表查询接口返回
      businessEffectiveDate String Y 商业险起保日期 精确报价接口推荐使用该日期,格式YYYY-MM-DD
      compelEffectiveDate String Y 交强险起保日期 精确报价接口推荐使用该日期,格式YYYY-MM-DD

      返回结果示例

      解密后内容
      {
          "importFlag": "B",
          "serialNum": "20171107152914856588",
          "vendorType": 4,
      	"businessEffectiveDate":"2017-11-15",
          "compelEffectiveDate": "2017-11-15"
      }
      																
    • 2.2.3精确报价接口

      根据车辆信息、险别信息、保险起保日期等信息查询出交强险商业险的价格以及优惠信息。保险起保日期推荐使用询价接口返回的相应起保日期, 用户亦可修改起保日期重新报价

      使用限制

      必须先调用询价申请接口

      请求参数

      参数名 含义 格式 是否必填 说明
      vendorType 保险公司类型 String 见附录
      serialNum 流水号 String 2.2.1接口车型列表查询接口返回
      businessEffectiveDate 商业险起保日期 String 首次报价使用询价接口返回的起保日期,用户亦可修改起期重新报价,格式YYYY-MM-DD
      isInsureCompelInsurance 是否投保交强险 String 是否投保交强险
      compelEffectiveDate 交强险起保日期 String 首次报价使用询价接口返回的起保日期,用户亦可修改起期重新报价,格式YYYY-MM-DD
      coverageList 商业险种列表 list 详见下
      coverageList 商业险种列表
      参数名 含义 格式 是否必填 说明
      coverageCode 险别代码 String 见附录-险种列表
      coverageName 险别名称 String
      sumInsured 保额 String 可选保额见附录各保险公司核保规则
      glassType 玻璃类型 String A-进口,B-国产
      compensationDays 补偿天数 String 修理期间补偿险时传送最长补偿天数

      特别说明

      1.众安的车损险、全车盗抢险、自燃损失险必须传入保额,车损险保额为车辆实际价值的0.7-1.3倍之间且不超过120万,盗抢险与自燃险的保额为车辆实际价值(实际价值调用4.2获取车辆实际价值接口);

      2.其它详见附录各保险公司核保规则。

      请求示例

      加密前明文:
      {
          "sign": "B1FA98C7EE0E7FA3B116CA6659DCDA92",
          "isInsureCompelInsurance": "1",
          "coverageList": [
              {
                  "sumInsured": "105000",
                  "coverageName": "机动车损失保险",
                  "coverageCode": "911"
              },
              {
                  "sumInsured": "200000",
                  "coverageName": "机动车第三者责任保险",
                  "coverageCode": "912"
              },
              {
                  "sumInsured": "105000",
                  "coverageName": "全车盗抢险",
                  "coverageCode": "915"
              },
              {
                  "sumInsured": "100000",
                  "coverageName": "机动车车上人员责任保险(司机)",
                  "coverageCode": "913"
              },
              {
                  "sumInsured": "150000",
                  "coverageName": "机动车车上人员责任保险(乘客)",
                  "coverageCode": "914"
              },
              {
                  "glassType": "B",
                  "coverageName": "玻璃单独破碎险",
                  "coverageCode": "91A"
              },
              {
                  "sumInsured": "105000",
                  "coverageName": "自燃损失险",
                  "coverageCode": "91B"
              },
              {
                  "coverageName": "发动机涉水损失险",
                  "coverageCode": "91E"
              },
              {
                  "sumInsured": "1510000",
                  "coverageName": "机动车损失保险无法找到第三方特约险",
                  "coverageCode": "91F"
              },
              {
                  "coverageName": "指定修理厂险",
                  "coverageCode": "91D"
              },
              {
                  "coverageName": "不计免赔率险-车损",
                  "coverageCode": "91G"
              },
              {
                  "coverageName": "不计免赔率险-商三",
                  "coverageCode": "91Q"
              },
              {
                  "coverageName": "不计免赔率险-盗抢",
                  "coverageCode": "91H"
              },
              {
                  "coverageName": "不计免赔率险-自燃",
                  "coverageCode": "91I"
              },
              {
                  "coverageName": "不计免赔率险-发动机涉水",
                  "coverageCode": "91K"
              },
              {
                  "coverageName": "不计免赔率险-司机",
                  "coverageCode": "91R"
              },
              {
                  "coverageName": "不计免赔率险-乘客",
                  "coverageCode": "91S"
              }
          ],
          "vendorType": 4,
          "businessEffectiveDate": "2017-11-15",
          "serialNum": "20171107152914856588",
          "compelEffectiveDate": "2017-11-15"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/detailPrice

      返回参数

      注:返回报文里商业险或交强险的保险起期可能与请求传入的起期不同,须以返回的日期为准。举例,请求报文,交强险起期2017-08-31,返回报文里,交强险起期:2017-09-15,则实际的交强险起期:2017-09-15,另外前端建议提示用户实际的起保日期。

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      vendorType String Y 保险公司类型
      serialNum String Y 交互流水号 商业+交强+车船税
      sumPreimum String 总保费
      businessSumPreimum String 商业险总保费
      businessDiscount String 商业险折扣系数
      compelSumPreimum String 交强险总保费
      taxPreimum String 车船税
      businessEffectiveDate String Y 商业险起保日期 格式YYYY-MM-DD
      isInsureCompelInsurance String Y 是否投保交强险 1-是,0-否
      compelEffectiveDate String Y 交强险起保日期 格式YYYY-MM-DD
      coverageList 商业险种列表
      参数名 含义 格式 是否必填 说明
      coverageCode 险别代码 String 见附录-险种列表
      coverageName 险别名称 String
      sumInsured 保额 String 可选保额见附录各保险公司核保规则
      glassType 玻璃类型 String A-进口,B-国产
      compensationDays 补偿天数 String 修理期间补偿险时传送最长补偿天数
      coveragePreimum 保费 String

      返回结果示例

      解密后内容
      {
          "businessDiscount": "1.0",
          "businessEffectiveDate": "2017-11-15",
          "businessSumPreimum": "7137.09",
          "compelEffectiveDate": "2017-11-15",
          "compelSumPreimum": "950.0",
          "coverageList": [
              {
                  "coverageCode": "911",
                  "coverageName": "机动车损失保险",
                  "coveragePreimum": "2384.3",
                  "sumInsured": "105000"
              },
              {
                  "coverageCode": "912",
                  "coverageName": "机动车第三者责任保险",
                  "coveragePreimum": "1370",
                  "sumInsured": "200000"
              },
              {
                  "coverageCode": "915",
                  "coverageName": "机动车全车盗抢保险",
                  "coveragePreimum": "666",
                  "sumInsured": "105000"
              },
              {
                  "coverageCode": "913",
                  "coverageName": "机动车车上人员责任保险(司机)",
                  "coveragePreimum": "210",
                  "sumInsured": "100000"
              },
              {
                  "coverageCode": "914",
                  "coverageName": "机动车车上人员责任保险(乘客)",
                  "coveragePreimum": "600",
                  "sumInsured": "150000"
              },
              {
                  "coverageCode": "91A",
                  "coverageName": "玻璃单独破碎险",
                  "coveragePreimum": "275.8"
              },
              {
                  "coverageCode": "91B",
                  "coverageName": "自燃损失险",
                  "coveragePreimum": "315",
                  "sumInsured": "105000"
              },
              {
                  "coverageCode": "91E",
                  "coverageName": "发动机涉水损失险",
                  "coveragePreimum": "119.22"
              },
              {
                  "coverageCode": "91F",
                  "coverageName": "机动车损失保险无法找到第三方特约险",
                  "coveragePreimum": "59.61",
                  "sumInsured": "1510000"
              },
              {
                  "coverageCode": "91D",
                  "coverageName": "指定修理厂险",
                  "coveragePreimum": "238.43"
              },
              {
                  "coverageCode": "91G",
                  "coverageName": "不计免赔率险-车损",
                  "coveragePreimum": "357.65"
              },
              {
                  "coverageCode": "91Q",
                  "coverageName": "不计免赔率险-三责",
                  "coveragePreimum": "205.5"
              },
              {
                  "coverageCode": "91H",
                  "coverageName": "不计免赔率险-盗抢",
                  "coveragePreimum": "133.2"
              },
              {
                  "coverageCode": "91I",
                  "coverageName": "不计免赔率险-自燃",
                  "coveragePreimum": "63"
              },
              {
                  "coverageCode": "91K",
                  "coverageName": "不计免赔率险-发动机涉水",
                  "coveragePreimum": "17.88"
              },
              {
                  "coverageCode": "91R",
                  "coverageName": "不计免赔率险-司机",
                  "coveragePreimum": "31.5"
              },
              {
                  "coverageCode": "91S",
                  "coverageName": "不计免赔率险-乘客",
                  "coveragePreimum": "90"
              }
          ],
          "isInsureCompelInsurance": "1",
          "serialNum": "20171107152914856588",
          "sumPreimum": "8507.09",
          "taxPreimum": "420.0",
          "vendorType": 4
      }
      																
    • 2.2.4核保及投保确认接口

      提交车主、投保人、被保人、收件人等相关信息进行投保操作,成功后返回订单号,用于后续支付申请

      请求参数

      参数名 含义 格式 是否必填 说明
      serialNum 流水号 String 2.2.1接口车型列表查询接口返回
      vendorType 保险公司类型 String 见附录
      applicantName 投保人姓名 String
      applicantCertificateNo 投保人证件号码 String
      applicantEmail 投保人邮件 String
      applicantDistrictCode 投保人区县编码 String 投保城市下的区县代码
      applicantAddress 投保人详细地址 String 区县以下的详细地址,不要带省市区信息
      applicantPhoneNo 投保人手机 String
      distributionProvinceCode 收件人省份编码 String
      distributionCityCode 收件人城市编码 String
      distributionDistrictCode 收件人区县编码 String
      distributionName 收件人姓名 String
      distributionAddress 收件详细地址 String
      distributionPhoneNo 收件人电话 String
      insurantName 被保人姓名 String 与询价申请接口中一致
      insurantCertificateNo 被保人证件号码 String 与询价申请接口中一致
      insurantPhoneNo 被保人手机 String
      insurantEmail 被保人邮件 String
      insurantDistrictCode 被保人区县编码 String 投保城市下的区县代码
      insurantAddress 被保人详细地址 String 区县以下的详细地址,不要带省市区信息
      underwritingNotifyUrl 承保通知地址 String 承保出单后,海豚向该地址发送通知

      请求示例

      加密前明文:
      {
          "applicantEmail": "389477255@qq.com",
          "insurantName": "张三",
          "insurantPhoneNo": "18612126666",
          "insurantAddress": "民治大道18号",
          "applicantAddress": "民治大道18号",
          "applicantPhoneNo": "18612126666",
          "insurantEmail": "389477255@qq.com",
          "applicantDistrictCode": "4403003",
          "sign": "27AE52AE1D6B763EB85C61001D1E6737",
          "distributionName": "李四",
          "vehicleOwnerName": "汪大伟",
          "underwritingNotifyUrl": "",
          "distributionAddress": "光明路10号",
          "distributionCityCode": "441900",
          "vendorType": 4,
          "insurantDistrictCode": "4403003",
          "distributionDistrictCode": "4419008",
          "serialNum": "20171107152914856588",
          "vehicleOwnerCertificateNo": "150522199304011411",
          "insurantCertificateNo": "150522199304011331",
          "applicantCertificateNo": "150522199304011331",
          "applicantName": "张三",
          "distributionPhoneNo": "18612126666",
          "distributionProvinceCode": "440000"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/confirmOrder

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      orderNo String Y 订单号 用于支付申请
      orderAmt String Y 订单金额 单位:分

      返回结果示例

      解密后内容
      {
          "orderAmt": 850709,
          "orderNo": "377486910823743488",
          "serialNum": "20171107152914856588",
          "vendorType": 4
      }
      																
    • 2.2.5支付申请接口

      海豚收到支付请求之后,会把请求跳转到第三方支付公司,注意这个接口不需要json传数据,直接通过get请求把参数加到url后面或者post提交参数就行

      使用限制

      注意:若保险公司类型为:人保,则不能通过该接口进行支付,需要调用海豚收银台进行支付,海豚收银台接口文档详见导航第四分类:

      请求参数

      参数名 含义 格式 是否必填 说明
      serialNum 流水号 String 2.2.1接口车型列表查询接口返回
      vendorType 保险公司类型 String 见附录
      orderNo 订单号 String 投保确认接口返回
      orderAmt 支付金额 String 与投保确认接口返回金额一致
      payWay 支付方式/环境 String 众安:1-移动端;2-PC 太平:1-微信环境;2-非微信环境、3-PC 天安:1-移动端;2-PC 众诚:0302电脑端支付;0401支付宝;0402微信公众号;0403微信扫码
      merchantCode 支付商户编号 String 由海豚分配
      notifyUrl 服务器异步通知路径 String
      returnUrl 支付完成跳转同步通知路径 String
      backUrl 交易关闭返回商户页面路径 String 交易失败、关闭返回的页面

      请求示例

      http://testapi.htbaobao.com/htbb-interface/api/car/applyPay?serialNum=20171107152914856588&
      vendorType=4&orderNo=377486910823743488&payWay=2&orderAmt=850709¬ifyUrl=http://testapi.htbaobao.com/
      htbb-interface/callback/car/test/payNotify&returnUrl=http://m.htbaobao.com&
      backUrl=http://m.htbaobao.com&merchantCode= 88888
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/applyPay

      返回参数

      直接跳转到第三方支付公司支付页面,支付成功会同步跳转到接口里面的returnUrl页面。

  • 2.3回调通知接口

    • 2.3.1支付成功通知

      用户支付成功后,海豚会向支付接口中的notifyUrl地址发送支付成功通知

      请求参数

      参数名 含义 格式 是否必填 说明
      trade_no 投保流水号 String 同投保流程中的serialNum(车型列表查询接口返回)
      carModel 订单号 String 投保确认接口返回的orderNo
      payTime 支付时间 String yyyy-MM-dd HH:mm:ss,经过了url编码,收到先解码
      amt 支付金额 String 单位:分
      payId 支付流水号 String
      notify_time 投保城市 String yyyy-MM-dd HH:mm:ss经过了url编码,收到先解码
      sign 签名 String orderId+trade_no+密钥进行md5签名
      签名字段生成规则:

      1.拼接参数值:orderId + trade_no + 支付商户密钥;(支付商户密钥需向海豚申请)

      2.利用 MD5 的签名函数对第1步中拼接的字符串进行签名运算,得到 32 位小写签名结果即作为sign字段的值。

      请求示例(notifyUrl)

      http://192.168.1.18:8080/test/notify.do?trade_no=111&orderId=1&payId=1&payTime=1&sign=1&amt=1¬ify_time=1

      说明

      收到通知后请返回:SUCCESS字符,表示合作者收到回调通知,海豚将不再对该笔订单进行通知

    • 2.3.2承保成功通知

      保险公司成功承保出单后,海豚会向投保接口中underwritingNotifyUrl地址发送承保通知及保单号

      请求参数

      参数名 含义 格式 是否必填 说明
      orderNo 订单号 String 投保确认接口返回
      serialNum 投保流水号 String
      policyType 保单类型 String 1 交强险 2 商业险
      policyNo 保单号 String 保单号(交强险/商业险)
      notify_time 投保城市 String yyyy-MM-dd HH:mm:ss经过了url编码,收到先解码
      sign 签名 String
      签名字段生成规则:

      1.拼接参数值:orderId + trade_no + 支付商户密钥;(支付商户密钥需向海豚申请)

      2.利用 MD5 的签名函数对第1步中拼接的字符串进行签名运算,得到 32 位小写签名结果即作为sign字段的值。

      请求示例(underwritingNotifyUrl)

      http://192.168.1.18:8080/test/policyNotify.do?orderNo=111&serialNum=1&policyType=1&payTime=1&sign=1&amt=1¬ify_time=1

      说明

      收到通知后请返回:SUCCESS字符,表示合作者收到回调通知,海豚将不再对该笔订单进行通知

  • 2.4辅助接口

    • 2.4.1查询车辆信息接口

      根据车主姓名与车牌号查询车辆行驶证基本信息

      使用限制

      暂支持的保险公司:众安

      请求参数

      参数名 含义 格式 是否必填 说明
      vendorType 保险公司类型 String 见附录
      vehicleLicencePlateNo 车牌号码 String
      vehicleOwnerName 车主姓名 String
      insurePlaceCode 投保城市代码 String

      请求示例

      加密前明文:
      {
          "sign": "1F1949E77B30F9A64DCC9E22CE57B17E",
          "vehicleOwnerName": "汪大伟",
          "vendorType": 4,
          "vehicleLicencePlateNo": "沪B2E816",
          "insurePlaceCode": "440300"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/ getCarInfo

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      vehicleLicencePlateNo String Y 车牌号
      vehicleBrand String Y 中文品牌
      vehicleModel String Y 车辆型号
      vehicleFrameNo String Y 车架号
      vehicleEngineNo String Y 发动机号
      vehicleRegisterDate String Y 车辆登记注册日期
      vehicleDtoList列表如下:
      参数代码 参数类型 非空 参数名称 备注
      modelCode String Y 车型代码
      modelName String Y 车型名称
      modelDesc String Y 车型描述
      brandName String Y 车型描述
      marketYear String Y 上市年份(年款)
      replacementValue String Y 新车购置价
      model String Y 车辆型号
      displaceMent String Y 排量
      factory String Y 生产厂家
      derailleurType String Y 变速器方式
      ratedPassengerCapacity String Y 额定载客人数
      series String Y 车系名称

      返回结果示例

      解密后内容
      {
          "vehicleBrand": "福克斯牌",
          "vehicleEngineNo": "DA***30",
          "vehicleFrameNo": "LV*************83",
          "vehicleLicencePlateNo": "沪B2E816",
          "vehicleModel": "CAF7201B4",
          "vehicleRegisterDate": "2013-07-25 00:00:00",
          "vendorType": 4
      }
      																
    • 2.4.2获取车辆实际价值接口

      根据起保日期和车的新车购置价计算出车的折旧率,并根据折旧率计算出车的实际价值

      使用限制

      暂支持的保险公司:众诚、众安

      请求参数

      参数名 含义 格式 是否必填 说明
      vendorType 保险公司类型 String 见附录
      serialNum 流水号 String 2.2.1接口车型列表查询接口返回
      startDate 车型代码 String 起保日期必须,根据起保日期算出车的实际价值,YYYY-MM-DD

      请求示例

      加密前明文:
      {
          "sign": "ECA03EDBB7CDE8A364C8DAF69F63E3B4",
          "startDate": "2017-11-15",
          "vendorType": 4,
          "serialNum": "20171107152914856588"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/getRealCarPrice

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      vehicleActualPrice String Y 车辆实际价值
      serialNum String Y 交互流水号

      返回结果示例

      解密后内容
      {
          "serialNum": "20171107152914856588",
          "vehicleActualPrice": "95702.60",
          "vendorType": 4
      }
      																
    • 2.4.3投保简要查询接口

      根据交互流水号serialNum、订单号查询投保简要、状态信息

      使用限制

      暂无

      请求参数

      参数名 含义 格式 是否必填 说明
      vendorType 保险公司类型 String 见附录
      serialNum 流水号 String 2.2.1接口车型列表查询接口返回
      orderNo 订单号 String 投保确认接口返回

      请求示例

      加密前明文:
      {
          "sign": "1F1949E77B30F9A64DCC9E22CE57B17E",
          "vendorType": 4,
          "serialNum": "20171107152914856588",
      	"orderNo": "377486910823743488"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/getOrderBriefInfo

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      orderNo String Y 订单号
      orderDate String Y 订单日期
      orderAmt String 订单金额 单位分
      custName String 投保人姓名
      custPhone String custPhone
      isuName String 被保人姓名
      isuPhone String 被保人手机号
      isuSsn String Y 被保人身份证号
      compelStatus String Y 交强险保单状态
      compelPolicyNo String Y 交强险保单号
      bussiStatus String Y 商业险保单状态
      bussiPolicyNo String Y 商业险保单号

      交强险、商业险保单状态:

      保单状态(0待支付,1待出单,2已出单,3已生效,4已终止,8已取消,9出单失败,10已退款)

      返回结果示例

      解密后内容
      {
          "orderNo": "1492496611754632",
          "orderDate": "2017-04-18 14:23:31",
          "orderAmt": "515000",
          "custName": "赵容",
          "custPhone": "15811111111",
          "isuName": "赵容",
          "isuPhone": "15811111111",
          "isuSsn": "432524199009220634",
          "compelStatus": "2",
          "compelPolicyNo ": "6203009080820170000141",
          "bussiStatus": "2",
      "bussiPolicyNo ": "6203009080820170000153"
      }
      																
    • 2.4.4投保详情查询接口

      根据交互流水号serialNum查询投保详细信息

      请求参数

      参数名 含义 格式 是否必填 说明
      serialNum 流水号 String 2.2.1接口车型列表查询接口返回
      vendorType 保险公司类型 String 见附录

      请求示例

      加密前明文:
      {
          "sign": "1F1949E77B30F9A64DCC9E22CE57B17E",
          "vendorType": 4,
          "serialNum": "20171107152914856588"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/getCarinsureDetail

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      TcCar String Y 车辆信息
      DetailPriceResponse String Y 报价信息
      ConfirmOrderRequest Object Y 确认投保信息
      TcCar参数说明:
      参数代码 参数类型 非空 参数名称 备注
      brandName String Y 品牌
      carModel String Y 车辆型号
      carOwner String Y 车主姓名
      ownerIdNum String Y 车主身份证
      phone String Y 车主电话
      frameNum String Y 车架号
      engineNum String Y engineNum
      enrollDate String Y 初次登记时间戳
      importFlag String Y 进口、国产 A:进口 B:国产
      displaceMent String Y 排量
      inCity String Y 投保城市代码
      isLicense String Y 是否上牌 1:是 0:否
      licenseNum String Y 车牌号码
      purchasePrice String Y 新车购置价
      seatCount String Y 坐位数量
      DetailPriceResponse 参数说明:
      参数代码 参数类型 非空 参数名称 备注
      serialNum String Y 流水号
      sumPreimum String Y 总保费 商业+交强+车船税
      businessSumPreimum String Y 商业险总保费
      businessDiscount String Y 商业险折扣系数
      compelSumPreimum String Y 交强险总保费
      taxPreimum String Y 车船税
      businessEffectiveDate String Y 商业险起保日期 格式YYYY-MM-DD
      isInsureCompelInsurance String Y 是否投保交强险 1-是,0-否
      compelEffectiveDate String Y 交强险起保日期 格式YYYY-MM-DD
      coverageList 商业险种列表 参数说明:
      参数代码 参数类型 非空 参数名称 备注
      coverageCode String Y 险别代码 见附录-险种列表
      coverageName String Y 险别名称
      sumInsured String Y 保额 可选保额见附录
      glassType String Y 玻璃类型 A-进口,B-国产
      compensationDays String Y 补偿天数 修理期间补偿险时传送最长补偿天数
      coveragePreimum String Y 保费
      ConfirmOrderRequest参数说明:
      参数代码 参数类型 非空 参数名称 备注
      serialNum String Y 流水号 车型列表查询接口返回
      vendorType String Y 保险公司类型 见附录
      applicantName String Y 投保人姓名
      applicantCertificateNo String Y 投保人证件号码
      applicantEmail String Y 投保人邮件
      applicantDistrictCode String Y 投保人区县编码 投保城市下的区县代码
      applicantAddress String Y 投保人详细地址 区县以下的详细地址,不要带省市区信息
      applicantPhoneNo String Y 投保人手机
      distributionProvinceCode String Y 收件人省份编码
      distributionCityCode String Y 收件人城市编码
      distributionDistrictCode String Y 收件人区县编码
      distributionName String Y 收件人姓名
      distributionAddress String Y 收件详细地址
      distributionPhoneNo String Y 收件人电话
      insurantName String Y 被保人姓名 与询价申请接口中一致
      insurantCertificateNo String Y 被保人证件号码 与询价申请接口中一致
      insurantPhoneNo String Y 被保人手机
      insurantEmail String Y 被保人邮件
      insurantDistrictCode String Y 被保人区县编码 投保城市下的区县代码
      insurantAddress String Y 被保人详细地址 区县以下的详细地址,不要带省市区信息
      underwritingNotifyUrl String Y 承保通知地址 承保出单后,海豚向该地址发送通知

      返回结果示例

      解密后内容
      {
          "ConfirmOrderRequest": {
              "applicantAddress": "民治大道18号",
              "applicantCertificateNo": "150522199304011331",
              "applicantDistrictCode": "360102",
              "applicantEmail": "389477255@qq.com",
              "applicantName": "张三",
              "applicantPhoneNo": "18612126666",
              "distributionAddress": "光明路10号",
              "distributionCityCode": "360100",
              "distributionDistrictCode": "360102",
              "distributionName": "李四",
              "distributionPhoneNo": "18612126666",
              "distributionProvinceCode": "360000",
              "insurantAddress": "民治大道18号",
              "insurantCertificateNo": "330101198801012058",
              "insurantDistrictCode": "360102",
              "insurantEmail": "389477255@qq.com",
              "insurantName": "梁如冰",
              "insurantPhoneNo": "18612126666",
              "partnerCode": "116",
              "serialNum": "20171129043153526569",
              "underwritingNotifyUrl": "http://thirdpart.com/policyNotify",
              "vendorType": 2
          },
          "TcCar": {
              "brandName": "丰田",
              "carAid": "385286732968509440",
              "carCode": "HGD1079TJF",
              "carModel": "丰田TV7164GD轿车",
              "carOwner": "梁如冰",
              "carType": "A0",
              "chgownerFlag": "0",
              "displaceMent": "1.598",
              "engineNum": "G141988",
              "enrollDate": 1347552000000,
              "frameNum": "LFMAP22C9C0438620",
              "importFlag": "B",
              "inCity": "440300",
              "isInsureBussi": "1",
              "isInsureCompel": "0",
              "isLicense": 1,
              "isSame": 0,
              "isTuobao": 0,
              "isuIdNum": "330101198801012058",
              "isuName": "梁如冰",
              "isuPhone": "13688881111",
              "licenseNum": "湘D27D18",
              "ownerIdNum": "330101198801012058",
              "ownerIdType": "01",
              "phone": "13688881111",
              "purchasePrice": "61418.4",
              "ratedPassengerCapacity": "5",
              "seatCount": "5",
              "transferDate": "",
              "useType": "8A"
          },
          "DetailPriceResponse": {
              "businessDiscount": "0.49",
              "businessEffectiveDate": "2017-12-28",
              "businessSumPreimum": "1848.17",
              "compelEffectiveDate": "2017-12-28",
              "compelSumPreimum": "0",
              "coverageList": [
                  {
                      "coverageCode": "911",
                      "coverageName": "机动车损失保险",
                      "coveragePreimum": "912.31",
                      "sumInsured": "60831.6"
                  },
                  {
                      "coverageCode": "912",
                      "coverageName": "机动车第三者责任保险",
                      "coveragePreimum": "671.3",
                      "sumInsured": "200000.0"
                  },
                  {
                      "coverageCode": "915",
                      "coverageName": "机动车全车盗抢保险",
                      "coveragePreimum": "213.8",
                      "sumInsured": "60831.6"
                  },
                  {
                      "coverageCode": "913",
                      "coverageName": "机动车车上人员责任保险(司机)",
                      "coveragePreimum": "5.15",
                      "sumInsured": "5000.0"
                  },
                  {
                      "coverageCode": "91E",
                      "coverageName": "发动机涉水损失险",
                      "coveragePreimum": "45.61",
                      "sumInsured": "0.0"
                  }
              ],
              "isInsureCompelInsurance": "0",
              "serialNum": "20171129043153526569",
              "sumPreimum": "1848.17",
              "taxPreimum": "0.0",
              "vendorType": 2
          }
      }
      																
    • 2.4.5查询贷款机构接口

      众安贷款车需要查询该接口获取贷款机构列表供用户选择

      使用限制

      暂支持的保险公司:众安

      http://www.htbaobao.com/html/docApi/docApi.html

      请求参数

      参数名 含义 格式 是否必填 说明
      vendorType 保险公司类型 String 见附录
      insurePlaceCode 投保城市代码 String

      请求示例

      {
          "sign": "1F1949E77B30F9A64DCC9E22CE57B17E",
          "vendorType": 4,
          "insurePlaceCode": "440300"
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/getLoan

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model下的data列表参数说明:
      参数代码 参数类型 非空 参数名称 备注
      org String Y 贷款机构
      subOrgs list Y 贷款分支机构名称列表

      返回结果示例

      解密后内容
      {
          "data": [
              {
                  "org": "中国工商银行股份有限公司上海田林支行",
                  "subOrgs": [
                      "中国工商银行股份有限公司上海田林支行-测试"
                  ]
              }
          ],
          "vendorType": 4
      }
      																
    • 2.4.6投保城市列表查询接口

      查询保险公司支持的投保城市列表

      使用限制

      见必填字段

      请求参数

      参数名 含义 格式 是否必填 说明
      vendorType 保险公司类型 String 见附录

      请求示例

      {
          "sign": "6E091F8627B761C682BEF9E3CDC02580",
          "vendorType": 4
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/getCityList

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model参数说明:
      参数代码 参数类型 非空 参数名称 备注
      totalCount String Y 总数量
      cityList list Y 城市列表
      cityList参数说明:
      参数代码 参数类型 非空 参数名称 备注
      name String Y 城市名称
      value String Y 城市代码
      parent String Y 所属省份代码 值为0表示当前记录为省份信息
      licensePlateNoPre String Y 车牌号前两位

      返回结果示例

      解密后内容
      {
          "vendorType": 4
          "totalCount": "122",
          "cityList": [
              {
                  "name": "湖南省",
                  "value": "430000",
                  "parent": "0",
                  "licensePlateNoPre": "湘"
              },
              {
                  "name": "长沙市",
                  "value": "430100",
                  "parent": "430000",
      			"licensePlateNoPre": "湘A"
              },
              {
                  "name": "株洲市",
                  "value": "430200",
                  "parent": "430000",
      			"licensePlateNoPre": "湘B"
              }
          ]
      }
      																
    • 2.4.7获取保险公司险种方案接口

      请求参数

      参数名 含义 格式 是否必填 说明
      user 用户名 String
      sign 加密签名 String
      vendorType 订单号 String 保险公司类型 见附录

      请求示例

      {
          "sign": "F0D21E01C1AAB90D120B3826DBB36E6A",
          "vendorType": 1
      }
      																

      接口路径

      http://testapi.htbaobao.com/htbb-interface/api/car/getCoveragInfoList

      返回参数

      参数代码 参数类型 非空 参数名称 备注
      msgCode String Y 反馈状态码 failed失败 success成功
      msg String Y 反馈信息
      model Object Y 数据对象
      model下的data下的CoverageBaseInfo列表参数说明:
      参数代码 参数类型 非空 参数名称 备注
      baseRiderType String Y 险别 0-主险,1-附加险
      coverageCode list N 险别代码
      coverageName String Y 险别名称
      isBaseRider String Y 是否为主险
      isNonDeductible String Y 是否为不计免赔险 0-否 1-是
      isNonDeductibleBool boolean Y 是否为不计免赔险
      parentCoverageCode String Y 附加险所属主险编码
      nonDeductibleCvrg CoverageBaseInfo Y 对应的不计免赔率险

      返回结果示例

      解密后内容
             "isBaseRider": false,
                      "isNonDeductible": "1",
                      "isNonDeductibleBool": true,
                      "parentCoverageCode": "91C"
                  },
                  "parentCoverageCode": "911"
              },
              {
                  "baseRiderType": "1",
                  "coverageCode": "91B",
                  "coverageName": "自燃损失险",
                  "isBaseRider": false,
                  "isNonDeductible": "0",
                  "isNonDeductibleBool": false,
                  "nonDeductibleCvrg": {
                      "baseRiderType": "1",
                      "coverageCode": "91I",
                      "coverageName": "不计免赔率险-自燃",
                      "isBaseRider": false,
                      "isNonDeductible": "1",
                      "isNonDeductibleBool": true,
                      "parentCoverageCode": "91B"
                  },
                  "parentCoverageCode": "911"
              },
              {
                  "baseRiderType": "1",
                  "coverageCode": "91A",
                  "coverageName": "玻璃单独破碎险",
                  "isBaseRider": false,
                  "isNonDeductible": "0",
                  "isNonDeductibleBool": false,
                  "parentCoverageCode": "911"
              }
          ],
          "vendorType": 1
      }
      																
  • 2.5附录

    • 2.5.1保险公司类型

      • 所有接口中vendorType字段取值范围:

        1众诚 2天安 3太平 4 众安 5 人保

    • 2.5.2险别列表

    • 2.5.3行政地区

      • 暂无,详询海豚(400-668-6008)
    • 2.5.4错误码

      • 暂无,详询海豚(400-668-6008)
    • 2.5.5核保规则

      • 暂无,详询海豚(400-668-6008)

3.公共

  • 3.1引言

    • 3.1.1目的

      本文档编写的主要目的是描述海豚大数据对外提供个险、车险等保险产品服务接口所公共的基础内容,以便于合作伙伴了解接口对接的相关细节。内容主要包括接口对接方式,交互协议,安全机制,业务流程,支付接口等。

    • 3.1.2接口地址

      测试地址

      http://testapi.htbaobao.com/htbb-interface/

    • 3.1.3交互协议

      属性 说明
      使用协议 HTTP/HTTPS
      数据格式 JSON
      请求方式 POST
      请求head 需要传递参数渠道代码partnerCode(值由海豚分配)
      POST内容 Json数据做AES加密后的字符串,详见【安全机制】
      Content-Type application/json
      password 访问密钥,用于签名(海豚分配)
      privatekey 报文AES加解密私钥(海豚分配)
    • 3.1.4安全机制

      安全机制主要从两方面处理:各请求接口都需要带上签名数据,以验证报文的完整性、一致性,并进行访问权限的认证;对传输的报文进行AES加密,以保护传输的内容。

      签名规则

      每个请求接口的签名字段(sign)的生成规则:参与签名的字段为相应请求接口中除sign之外的所有字段与访问密钥。对所有待签名的请求参数按照字段名的ASCII 码从小到大排序后,使用键值对的格式(即key1=value1&key2=value2…)拼接成字符串tmpStr,再拼接“&password=访问密钥(海豚为每个合作伙伴分配测试及生产密钥)”成str1。对str1作md5加密,即sign=md5(str1),字符集编码为utf-8。

      示例:

      user=testUser

      partnerCode=partcode01

      hbCode=hb0001

      tradeNum=14000001111111

      payType=0

      步骤1. 对所有待签名参数按照字段名的ASCII 码从小到大排序后,使用键值对的格式(即key1=value1&key2=value2…)拼接成字符串tmpStr:

      hbCode=hb0001&partnerCode=partcode01&payType=0&tradeNum=14000001111111&user=testUser

      步骤2. 将访问密钥拼接到tmpStr后面,得到str1:

      hbCode=hb0001&partnerCode=partcode01&payType=0&tradeNum=14000001111111&user=testUser&password=访问密钥

      步骤3. 对str1进行md5签名,得到sign的值:

      DCEFB5506082703993524EFD8E7A8651

      报文加解密

      对生成的请求JSON数据(含签名信息),需要用海豚分配的privatekey进行AES加密后再进行POST请求,海豚返回报文用相同的privatekey做AES加密,即收到返回报文需要进行对应的解密操作才能得到原JSON数据,字符集编码为utf-8。

      1) JAVA平台

      AES加解密模式:工作模式为ECB,填充方式为PKCS5Padding。

      示例代码(java):

      发送post前加密调用:AESUtil.aesEncrypt(Json字符串, privatekey, ‘UTF-8’);

      收到响应后解密调用:AESUtil.aesDecrypt (响应的model内容, privatekey, ‘UTF-8’);

      2) C#平台(或其它类型):

      加解密密钥privatekey请咨询海豚相关技术人员提供,也可以自行根据password获取加解密密钥,获取地址为:

      http://testapi.htbaobao.com/htbb-interface/v2/testTool/getPrivateKey4NonJavaClient?password=访问密码。

      示例代码(c#):

      其它类型平台类似处理。

    • 3.1.5接口流程

4.收银台

  • 4.1文档说明

    • 功能描述

      商户使用该接口后,可以让付款者直接把款项支付给海豚。

      阅读对象

      收银台接口文档是面向有一定开发能力,会使用http协议,掌握目前常用的开发语言中的一种的网站开发、维护和管理人员。

      版本说明

      2017-07-28 v1.0 初始版本

  • 4.2支付场景

    • 支付宝:

      PC端:扫码支付、即时到账支付,两者由海豚二选一。

      移动端:直接唤醒APP客户端。

      微信:

      PC端:扫码支付。

      移动端:微信浏览器(公众号支付),非微信浏览器(H5支付)。

      银联支付:PC端和移动端一样,页面自适应。

  • 4.3功能演示

    • 4.3.1PC版本演示

      商户提交接口以后跳转的页面如下: 点击微信支付,PC端默认进行扫码支付: 点击支付宝支付,PC端默认跳转到扫码支付:
      即时到账支付: 扫码支付: 支付成功页面: 支付失败: 银联支付:
    • 4.3.2移动端演示

      移动端微信支付有两种情况:

      1)微信浏览器:采用公众号进行支付。

      2)非微信浏览器:采用H5手机网站支付。

      移动端支付宝支付通过H5手机网站支付调支付宝客户端进行支付,如下图 银联支付
  • 4.4接入说明

    • 收银台支持PC端、移动端,收银台会自动兼容两种模式。
      1)构造请求数据

      商户根据海豚保险提供的接口规则,通过程序生成得到签名结果及要传输给海豚的数据集合。请求协议:http接口。

      2)发送请求数据

      把构造完成的数据集合,通过post请求方式传输给海豚网关。可以采用表单提交方式。

      3)海豚保险处理请求交易

      海豚保险得到这些数据集合后,会先进行安全校验等验证,验证通过后便会处理这次发送过来的数据请求。

      4)用户完成支付

      用户在海豚保险的提供的页面上使用适合自己的支付方式完成支付。

      5)通知商户交易状态

      对于处理完成的交易,海豚会以两种方式把数据反馈给商户网站。

      a) 页面同步发起通知,支付成功后进入海豚支付成功页面,默认10秒钟后跳转到商户的同步跳转页面(参数return_url,如果商户没有设定,则不会进行该操作);

      b) 海豚保险服务器主动发起通知,支付成功后会进行回调通知(参数notify_url)。

      6)商户处理交易通知

      商户在同步通知处理页面(参数returnurl)或服务器异步通知页面(参数notifyurl)获取海豚保险的结果数据后,可以结合自身网站的业务逻辑进行数据处理(如:订单更新、投保出单等)。

  • 4.5请求参数说明

    • 4.5.1访问地址

      测试环境:

      http://testpay.htbaobao.com/htbbpay/gateway.do

    • 4.5.2含义

      请求参数是商户与海豚保险进行数据交互时,提供给海豚保险的请求数据,以便海豚保险根据这些数据进一步处理。

      参数列表

      参数名 含义 格式 必填 说明
      request_charset 参数编码 String 当前只支持UTF-8
      sign_type 签名类型 String 当前只支持MD5
      sign 签名 String 见签名方式
      out_trade_no 订单号 String 订单号和核保单号必填其一
      isuId 核保单号 String
      merchant_code 商户编码 String 海豚提供
      subject 商品名称 String
      body 商品描述 String
      amt 订单金额 String 单位RMB元,精确到小数字点后两位
      expiry_time 订单有效时间 String 单位:分钟,预留字段
      pay_channel 可用支付渠道 String alipay-wxpay-unionpay,支付方式多种提供中横线隔开,支付页面会按照这个先后顺序排序显示
      notify_url 服务器异步通知路径 String 可带参数,传送过来支持url编码
      return_url 支付成功跳转同步通知路径 String 可以带参数,传送过来支持url编码
      fail_url 支付失败跳转同步通知路径 String 可以带参数,传送过来支持url编码
      notify_info 公用回传参数 String json格式进行base64加密,最长255
      prod_type 产品类型 String N普通产品 C受控产品
      openid 微信openid String 公众号支付用到
      此接口支持重复调用,前提是交易尚未完成支付;

      样例

      http://testpay.htbaobao.com/htbbpay/gateway.do?request_charset=UTF-8&body=bxdd&subject=bx&sign_type=MD5

      {{crash0}}

      {{crash1}}

      {{crash2}}

      {{crash3}}

      pay_channel=wxpay-alipay-unionpay&prod_type=N

    • 4.5.3异步通知参数说明

      含义

      1)页面跳转:

      海豚保险对商户的请求数据处理完成后,海豚会把同步页面页面传递给支付宝、微信等第三方支付平台,支付成功后会跳转到提供的页面,页面不能带任何参数。

      2)服务器异步通知:

      海豚保险对商户请求数据处理完成后,会将处理的数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。

      参数列表

      参数名 含义 格式 必填 说明
      trade_no 交易流水号 String 微信或者支付宝的流水号
      orderId 订单号 String
      isuId 核保单号 String
      payId 海豚支付单号 String
      payTime 支付时间 String yyyy-MM-dd HH:mm:ss,经过了url编码,收到先解码
      sign 签名 String orderId+trade_no+密钥进行md5签名
      merchant_code 商户编码 String 海豚提供
      amt 订单金额 String 单位RMB元,精确到小数字点后两位
      notify_time 通知时间 String yyyy-MM-dd HH:mm:ss经过了url编码,收到先解码
      notifyInfo 公用回传参数 String 商户传给海豚的,海豚原样返回,长度限制2000

      请求样例

      http://192.168.1.18:8080/test/notify.do?trade_no=1&orderId=1&payId=1&payTime=1&sign=1&merchant_code=1&amt=1¬ify_time=1
    • 4.5.4通知返回数据处理

      1. 页面跳转同步通知特性

      1)付款用户在支付成功后会自动跳转回商户制定的同步通知页面(参数return_url)。

      2)该页面中获得参数的方式,需要使用get方式获取。

      3)该方式仅仅在付款用户付款完成以后进行自行跳转,所有只会进行一次。

      4)该方式不是海豚保险主动去调用商户页面,第三方支付成功后当前页面自动跳转。

      5)该方式可在本机而不是只能在服务器上进行调试

      2. 服务器异步通知特性

      1)必须保证服务器异步通知页面(notify_url)上无任何字符,如空格、html标签、开发系统自带的抛出异常提示信息等;

      2)海豚保险是用post方式发送通知信息,因此该页面中获取参数的方式需要使用post方式获得,url参数直接拼接,需要接收方进行url解码为
      UTF-8。

      3)海豚保险主动发起通知。该方式才会被启用

      4)只有海豚保险的交易管理中存在该笔交易,并且交易状态由【未支付】变为【支付成功】后,海豚保险才会通过该方式发起服务器通知。

      5)第一次通知会和页面跳转同步通知一起发出。

      6)程序执行完后必须打印输出SUCCESS。如果商户反馈给海豚保险的字符不是SUCCESS这7个字符,海豚保险服务器会不断的重发通知,直到超过通知次数上限。通知间隔频率为:(0秒,5分钟,10分钟,30分钟,1小时,24小时),总共24小时6次。

      3. 商户业务处理注意事项

      当付款用户完成支付后,海豚保险会把处理结果以当前页面跳转同步通知和海豚保险服务器主动通知商户网站两种形式,反馈给商户网站。商户可以从页面跳转同步通知页面或者从服务器异步通知页面中获得这些信息,并且在验证通过的判断中增加商户的业务逻辑处理程序。 海豚保险建议商户业务逻辑的执行,以收到服务器异步通知为准。

      当商户有传递参数 notifyurl(服务器异步通知页面路径)或 returnurl(页面跳转 同步通知页面路径)时,商户必须验证签名,验证金额,,并且过滤重复的通知结果数据。如果商户未正确处理业务通知,存在潜在的风险,商户自行承担因此而产生的所有损失。

    • 4.5.5签名机制

      生成待签名的字符串

      在请求参数列表中,除去 sign、signtype 两个参数外,其他需要使用到的参数皆是要签名的参数(包括不在收银台参数列表中的)。在通知返回参数列表中,除去 sign、signtype 两个参数外,凡是通知返回回来的参数皆是要签名的参数。

      对于如下的参数集合,每一个参数按照key值从a到z的排序顺序,若遇到相同首字母,则看第二个字母,以此类推。排序完成之后,再把所有数组值以“&”字符连接起来,并加上商户密钥,假如商户密钥是123456,则签名字符串如下:

      htbbpay/pay/getTcPayDetail?request_charset=UTF-8&out_trade_no=339719717210046462&pay_channel=wxpay|alipay

      &request_charset=UTF-8&return_url=https://www.sohu.com&subject=bx123456

      签名

      在MD5签名是,需要海豚保险安全校验码,即key。每个商户的安全校验码(key)可以向海豚请求获取。

      1) 请求时签名 当拿到请求时的待签名字符串后,需要把安全校验码(Key)直接拼接到待签名字符串后面,形成新的字符串,利用 MD5 的签名函数对这个新的字符串进行签名运 算,从而得到 32 位小写签名结果字符串(该字符串赋值于参数sign)。

      2) 通知返回时验证签名 当获得到通知返回时的待签名字符串后,同理,需要把安全校验码(Key)直接拼接到待签名字符串后面,形成新的字符串,利用 MD5 的签名函数对这个新的字符 串进行签名运算,从而得到32位小写签名结果字符串。此时这个新的字符串需要与海豚保险通知返回参数中的参数sign的值进行验证是否相等,来判断签名是否验证通过。

  • 4.6接入说明

    • 获取支付详情接口

      功能介绍

      获取支付单号获取支付相关信息。

      接口参数

      参数名 含义 格式 是否必填 说明
      payId 支付单号 String

      返回值

      		{
      		    "errCode": 0,
      		    "resultMsg": "成功",
      		    "resultData": {
      		        "payId": "340414619703514020",
      		        "orderId": "339719717210046462",
      		        "payAmt": 2,
      		        "payStatus": 1,
      		        "payTime": null,
      		        "payWay": null,
      		        "tradeNum": null
      		    }
      		}
      		

      返回值说明

      参数 参数含义 数据类型 备注
      errCode 错误代码 Integer 0代表成功 其它失败
      resultMsg 返回信息 string
      resultData 返回数据 Objec 见下面
      参数 参数含义 数据类型 备注
      payId 支付id Integer 0代表成功 其它失败
      orderId 订单号 string
      payAmt 支付金额 int 单位分
      payStatus 支付状态 int 0待支付,1支付成功,2支付失败
      payTime 支付时间 string yyyy-mm-dd hh:hi:ss
      payWay 支付方式 int 1微信,2支付宝,3银联
      tradeNum 支付交易号 string

联系我们


微信公众号

邮箱:haitun@htbaobao.com

服务热线:400-668-6008 (工作日09:00-22:00)

合作热线:0755-82181008 (工作日09:00-18:30)

微信:“海豚保险网”公众号

官网:“海豚保险网”或haitunbx.com

地址:深圳市南山区宝深路科陆大厦A座13楼1302室