[关闭]
@15311494814 2017-04-07T01:58:52.000000Z 字数 7677 阅读 473

积分换购接口文档

零、redis表说明

【1】 tbl_insurancerecord:东航的保单信息表

  1. {globalno:"",appno: "",name:"",plateno: "",businesspre: "",jqxpre: "",vehicletax: "",sumpre: "",sessionid:"",createtime:"",status:""}
字段 说明
globalno 全局流水号
appno 保单号
name 车主姓名
plateno 车辆号牌
businesspre 商业险费用
jqxpre 交强险费用
vehicletax 车船税费用
sumpre 保险总费用
sessionid 车主sessionid
createtime 创建时间
status 保单状态 
  1. 注：保单状态:
  2. 已投保待支付 0    天安生成订单号和投保号时通知东航接口后
  3. 业务状态 1  待支付 用户支付前到天安进行支付校验返回结果为可支付后
  4. 业务状态 2  不可支付    用户支付前到天安进行支付校验返回结果为不可支付后
  5. 业务状态 3  已支付待转账  用户支付成功后到通知融石科技转账前
  6. 业务状态 4  已通知转账待确认    通知融石科技转账后到返回转账结果前
  7. 业务状态 5  已转账待承保  融石科技转账成功到通知天安返回承保结果前
  8. 业务状态 6  转账失败待退款 融石科技返回转账失败
  9. 业务状态 7  承保完成    融石科技返回承保成功
  10. 业务状态 8  承保失败待退款

【2】 tbl_orderrecord:东航的订单信息记录表

  1. {globalno:"",appno:"",sessionid:"",score:"",cash:"",status:"",createtime:""}
字段 说明
globalno 全局流水号
appno 投保单号
sessionid 用户sessionid
score 用户使用积分数量
cash 用户使用现金数量
status 订单状态
createtime 订单创建时间 
  1. 注：订单状态
  2. 已投保待支付 0    天安生成订单号和投保号时通知东航接口后
  3. 已支付待承保 1    用户支付成功后到天安承保结果返回前
  4. 承保成功 2  天安承保成功通知东航接口后
  5. 承保失败待退款 3   天安承保失败通知东航接口后

【3】 tbl_transferrecord:融石的转账信息记录表

  1. {globalno:"",appno:"",name:"",plateno:"",businesspre:"",jqxpre:"",vehicletax:"",sumpre:"",score:"",cash:"",createtime:"",payresult:"",failedreason:"",status:""}
字段 说明
globalno 全局流水号
appno 投保单号
name 车主姓名
plateno 车辆号牌
businesspre 商业险费用
jqxpre 交强险费用
vehicletax 车船税费用
sumpre 保险总费用
score 用户使用积分数量
cash 用户使用现金数量
status 转账状态
createtime 创建时间 
  1. 注：转账状态
  2. 未通知转账 0 接收到东航订单成功，为通知天安扣款
  3. 已通知转账 1 已通知天安扣款，为接收到结果
  4. 转账成功 2 已接收到转账成功，未接收到承保结果
  5. 转账失败 3 已接受到转账失败
  6. 承保成功 4 已接受承保成功
  7. 承保失败 5 已接受承保失败

【4】 tbl_insurancepolicyrecord:天安的保单信息记录表

  1. {globalno:"",appno:"",name:"",plateno:"",businesspre:"",jqxpre:"",vehicletax:"",sumpre:"",createtime:"",status:""}
字段 说明
globalno 全局流水号
appno 投保单号
name 车主姓名
plateno 车辆号牌
businesspre 商业险费用
jqxpre 交强险费用
vehicletax 车船税费用
sumpre 保险总费用
status 保单状态
createtime 创建时间 
  1. 注：保单状态
  2. 未付款 0 天安收到用户付款成功之前
  3. 已付款未承保 1 保单收到付款通知之后，未进行承保之前
  4. 承保失败 2 保单承保失败
  5. 承保成功 3 保单承保成功

【5】 listener-createinsurancepolicyinfo:东航的创建保单监听表

数据示例:

  1. { globalno: "",appno: "",name: "",plateno: "",businesspre: "",jqxpre: "",vehicletax: "",sumpre: ""}

【6】 listener-recivetransferresult:东航的转账结果接收监听表

数据示例:

  1. {
  2.     globalno: "",result:"success",reason:""
  3. }

【7】 listener-reciveacceptanceresult:东航的承保结果监听表

数据示例:

  1.             {            
  2.              globalno: "S2I2017032800001",
  3.              polno:"6703530136320170000695",
  4.              result:"success",
  5.              reason:""    
  6.             }

【8】 listener-checkorderpayablestatus:天安的支付校检监听表

数据示例:

  1.             { 
  2.                globalno: "S2I2017032800001",
  3.                appno: "0703500136320170000648"      
  4.             }

【9】 listener-recivepayrequest:天安的支付扣款请求监听表

数据示例:

  1.             {
  2.               globalno: "S2I2017032800001",   
  3.               appno: "0703500136320170000648"
  4.             }

一、东航模拟

【1】 生成订单

功能 : 此URL供天安提交保单信息后回调使用，核保成功传入sessionid，核保失败传入失败信息
路径 ： GET shop-s2i/tashoporder
参数 : 

  1. ?sessionid=ssd23123j1232
  2. ?reason=%E8%BD%A6%E8%BE%86%E4%BF%A1%E6%81%AF%E

正确返回：

  1. {
  2.  "statusCode" : "000000",
  3.  "result": "ok",//接收成功返回ok
  4.  "desc":"" 
  5. }
参数 是否必须 说明
sessionid 否 东航生成的用户sessionid
reason 否 失败的描述信息

**注：sessionid和reason二选一

返回值 说明
result 接收成功返回ok
desc 失败信息

【2】创建保单信息

功能 ： 天安将已保存投保信息发送给东航，东航接收到用于创建保单，保存保单信息，并返回给天安用户sessionid.
路径 ： PUT shop-s2i/createinsurancepolicyinfo
body：

  1. {
  2.     globalno: "S2I2017032800001",   //全局流水号
  3.     appno: "0703500136320170000648",//投保单号
  4.     name: "张德智",                 //车主姓名
  5.     plateno: "陕CC0969",            //车辆号牌
  6.     businesspre: "3762.58",         //商业险费用
  7.     jqxpre: "760.00",               //交强险费用
  8.     vehicletax: "720.00",           //车船税费用
  9.     sumpre: "5242.58"               //保险总费用
  10. }

返回结果:

  1. {
  2.     statusCode: "000000",           //成功返回 6个0
  3.     desc: "",                       //错误信息
  4.     result: "g3k2d3h5v4t3j1j"       //返回sessionid
  5. }
参数 必填 说明
globalno 是 全局流水号
appno 是 投保单号
name 是 车主姓名
plateno 是 车辆号牌
businesspre 是 商业险费用
jqxpre 是 交强险费用
vehicletax 是 车船税费用
sumpre 是 保险总费用
正确返回值 说明
result 接收成功返回sessionid
desc 失败信息

【3】 接收融石的转账结果

功能 : 调用返回融石的转账结果
路径 ： PUT shop-s2i/recivetransferresult
body : 

  1. {
  2.  globalno: "S2I2017032800001",//全局流水号
  3.  result:"success",//success 为转账成功,fault 为转账失败
  4.  reason:"" //转账成功的时候 此项为空,转账失败的时候 此项为失败原因
  5. }

正确返回：

  1. {
  2.     statusCode: "000000",           //成功返回 6个0
  3.     desc: "",                       //错误信息
  4.     result: "ok"                    //返回ok
  5. }
参数 是否必须 说明
globalno 是 全局流水号
result 是 转账结果:success 为转账成功,fault 为转账失败
reason 否 转账失败为失败原因，转账成功为空
返回值 说明
result ok
desc 失败显示信息

### 【4】 接收承保结果

功能 : 调用返回融石的承保结果
路径 ： PUT shop-s2i/reciveacceptanceresult
body : 

  1. {
  2.   globalno: "S2I2017032800001",   //全局流水号
  3.   polno:"6703530136320170000695", //保单号,当承保失败为空
  4.   result:"success",//success 为承保成功,fault 为承保失败
  5.   reason:""//承保成功为空,承保失败为失败原因
  6. {

正确返回：

  1. {
  2.     statusCode: "000000",           //成功返回 6个0
  3.     desc: "",                       //错误信息
  4.     result: "ok"                    //返回ok
  5. }
参数 是否必须 说明
globalno 是 全局流水号
polno 否 保单号,当承保失败为空
result 是 success 为承保成功,fault 为承保失败
reason 否 承保成功为空,承保失败为失败原因
返回值 说明
result ok
desc 失败显示信息

二、天安模拟

【1】 支付校验

功能 : 校验保单是否可以支付
路径 ： PUT ta-s2i/checkorderpayablestatus
body : 

  1. {
  2.     globalno: "S2I2017032800001",       //全局流水号
  3.     appno: "0703500136320170000648"     //投保单号
  4. }

正确返回：

  1. {
  2.   statusCode: "000000",           //成功返回 6个0
  3.   desc: "",                       //不可支付显示原因
  4.   result: "ok"                    //可支付显示ok
  5. }
参数 是否必须 说明
globalno 是 全局流水号
appno 是 投保单号
返回值 说明
result 可支付显示ok
desc 不可支付显示不可支付原因

【2】接收融石扣款请求

功能 ： 融石调用，接收融石的扣款请求
路径 ： PUT ta-s2i/recivepayrequest
body：

  1. {
  2.     globalno: "S2I2017032800001",       //全局流水号
  3.     appno: "0703500136320170000648"     //投保单号
  4. }

正确返回:

  1. {
  2.     statusCode: "000000",           //成功返回 6个0
  3.     desc: "",                       //错误信息
  4.     result: "ok"                    //返回ok
  5. }
参数 必填 说明
globalno 是 全局流水号
appno 是 投保单号
正确返回值 说明
desc 扣款失败显示错误信息
result 扣款成功显示返回ok

三、融石模拟

【1】 接收转账请求

功能 : 东航请求融石发起转账
路径 ： PUT rongstone-s2i/recivetransferrequest
body : 

  1. {
  2.     globalno: "S2I2017032800001",   //全局流水号
  3.     appno: "0703500136320170000648",//投保单号
  4.     name: "张德智",                 //车主姓名
  5.     plateno: "陕CC0969",            //车辆号牌
  6.     businesspre: "3762.58",         //商业险费用
  7.     jqxpre: "760.00",               //交强险费用
  8.     vehicletax: "720.00",           //车船税费用
  9.     sumpre: "5242.58",              //保险总费用
  10.     score:"2000",                   //用户使用积分数量
  11.     cash:"3242.58",                 //用户使用现金数量
  12. }

正确返回：

  1. {
  2.   statusCode: "000000",           //成功返回 6个0
  3.   desc: "",                       //错误信息
  4.   result: "ok"                    //返回ok
  5. }
参数 是否必须 说明
globalno 是 全局流水号
appno 是 投保单号
name 是 车主姓名
plateno 是 车辆号牌
businesspre 是 商业险费用
jqxpre 是 交强险费用
vehicletax 是 车船税费用
sumpre 是 保险总费用
score 是 用户使用积分数量
cash 是 用户使用现金数量
返回值 说明
result 成功返回ok
desc 失败描述信息

【2】接收扣款结果

功能 ： 天安调用，融石接收天安的扣款结果
路径 ： PUT rongstone-s2i/recivepayresult
body：

  1. {
  2.     globalno: "S2I2017032800001",   //全局流水号
  3.     result:"success",//success 为扣款成功,fault 为扣款失败
  4.     reason:"" //扣款成功为空,扣款失败为失败原因
  5. }

正确返回:

  1. {
  2.     statusCode: "000000",           //成功返回 6个0
  3.     desc: "",                       //错误信息
  4.     result: "ok"                    //返回ok
  5. }
参数 必填 说明
globalno 是 全局流水号
result 是 扣款结果,success 为扣款成功,fault 为扣款失败
reason 否 扣款结果，扣款成功为空,扣款失败为失败原因
正确返回值 说明
result 扣款成功为ok失败为空
desc 扣款失败为失败原因，成功为空

【3】 接收承保结果

功能 : 天安调用，融石接收天安的承保结果
路径 ： PUT rongstone-s2i/reciveacceptanceresult
body : 

  1. {
  2.     globalno: "S2I2017032800001",   //全局流水号
  3.     polno:"6703530136320170000695", //保单号,承保失败为空
  4.     result:"success",//success 为承保成功,fault 为承保失败
  5.     reason:"" //承保成功为空,承保失败失败原因
  6. }

正确返回：

  1. {
  2.     statusCode: "000000",           //成功返回 6个0
  3.     desc: "",                       //错误信息
  4.     result: "ok"                    //返回ok
  5. }
参数 是否必须 说明
globalno 是 全局流水号
polno 是 保单号
result 是 承保结果，success 为承保成功,fault 为承保失败
reason 否 失败原因，承保成功为空,承保失败失败原因
返回值 说明
result ok表示已收到
desc 接收失败原因

四、监听接口

【1】 监听天安调用东航的创建保单接口

功能 : 轮询查询临时监听表：listener-createinsurancepolicyinfo
路径 ： get listener/createinsurancepolicyinfo
正确返回：

  1. {
  2.     statusCode: "000000",   
  3.     desc: "",                    
  4.     result:{  globalno: "S2I2017032800001",   
  5.               appno: "0703500136320170000648",
  6.               name: "张德智", 
  7.               plateno: "陕CC0969",            
  8.               businesspre: "3762.58",        
  9.               jqxpre: "760.00",               
  10.               vehicletax: "720.00",           
  11.               sumpre: "5242.58"              
  12.             }
  13. }

功能描述:

  1. 0，所对应表：listener-createinsurancepolicyinfo
  2. 1，每次在调用东航的创建保单接口时，会在表中更新一条数据。
  3. 2，在点击开启时，先删除表中数据，再轮询查询，该表最多只有一条数据，当调用了创建保单接口，则会获取到表中数据。
  4. 3，监听到数据后，轮询停止。
  5. 4，再次点击再先删除后轮询。

【2】 监听融石调用东航的接收转账结果接口

功能 : 轮询查询临时监听表：listener-recivetransferresult
路径 ： get listener/recivetransferresult
正确返回：

  1. {
  2.     statusCode: "000000",   
  3.     desc: "",                    
  4.     result:{ 
  5.              globalno: "S2I2017032800001",
  6.              result:"success",
  7.              reason:""
  8.            }
  9. }

功能描述:

  1. 0，所对应表：listener-recivetransferresult
  2. 1，每次在调用东航的接收转账结果接口时，会在表中更新一条数据。
  3. 2，在点击开启时，先删除表中数据，再轮询查询，该表最多只有一条数据，当调用了接收转账结果接口，则会获取到表中数据。
  4. 3，监听到数据后，轮询停止。
  5. 4，再次点击再先删除后轮询。

【3】 监听融石调用东航的接收承保结果接口

功能 : 轮询查询临时监听表：listener-reciveacceptanceresult
路径 ： get listener/reciveacceptanceresult
正确返回：

  1. {
  2.     statusCode: "000000",   
  3.     desc: "",                    
  4.     result:{ 
  5.              globalno: "S2I2017032800001",
  6.              polno:"6703530136320170000695",
  7.              result:"success",
  8.              reason:""    
  9.             }
  10. }

功能描述:

  1. 0，所对应表：listener-reciveacceptanceresult
  2. 1，每次在调用东航的接收承保结果接口时，会在表中更新一条数据。
  3. 2，在点击开启时，先删除表中数据，再轮询查询，该表最多只有一条数据，当调用了接收承保结果接口，则会获取到表中数据。
  4. 3，监听到数据后，轮询停止。
  5. 4，再次点击再先删除后轮询。

【4】 监听东航调用天安的支付校检接口

功能 : 轮询查询临时监听表：listener-checkorderpayablestatus
路径 ： GET listener/checkorderpayablestatus
正确返回：

  1. {
  2.     statusCode: "000000",   
  3.     desc: "",                    
  4.     result:{   
  5.                globalno: "S2I2017032800001",
  6.                appno: "0703500136320170000648"      
  7.             }
  8. }

功能描述:

  1. 0，所对应表：listener-checkorderpayablestatus
  2. 1，每次在调用天安的支付校验接口时，会在表中更新一条数据。
  3. 2，在点击开启时，先删除表中数据，再轮询查询，该表最多只有一条数据，当调用了支付校验接口，则会获取到表中数据。
  4. 3，监听到数据后，轮询停止。
  5. 4，再次点击再先删除后轮询。

【5】 监听融石调用天安的接收扣款请求接口

功能 : 轮询查询临时监听表：listener-recivepayrequest
路径 ： get listener/recivepayrequest
正确返回：

  1. {
  2.     statusCode: "000000",   
  3.     desc: "",                    
  4.     result:{  globalno: "S2I2017032800001",   
  5.               appno: "0703500136320170000648"
  6.             }
  7. }

功能描述:

  1. 0，所对应表：listener-recivepayrequest
  2. 1，每次在调用天安的接收扣款请求接口时，会在表中更新一条数据。
  3. 2，在点击开启时，先删除表中数据，再轮询查询，该表最多只有一条数据，当调用了接收扣款请求接口，则会获取到表中数据。
  4. 3，监听到数据后，轮询停止。
  5. 4，再次点击再先删除后轮询。
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注