星灿保代保险平台接口文档

苏宁保与外部的接口文档


退保信息推送

接口概述

1.当用户在保险公司退保完成后,保险公司需通过提供的接口地址回传退保信息给星灿保代 2.若推送发生异常,请保险公司务必有重试机制

推送地址

测试环境 :https://ftpgsprexg.cnsuning.com/ftpgs/trade/iosGatewayService/cancel 生产环境 :https://mfg.suning.com/ftpgs/trade/iosGatewayService/cancel

安全机制

AES加密 1、请求报文先用AES加密后Base64转码, 秘钥值由星灿保代提供 2、响应报文先用Base64解码后用AES解密 3、加密后的字符串,用key-value结构传参。{requestParam:加密字符串}

请求头

请求头加一对 key-value Key: terminalType Value: EPP_IOS

请求数据

字段 类型 必传 描述 说明
supplierCode String Y 供应商编码 合作方编码,由苏宁分配
policyNo String Y 保单号
cancelTime String Y 退保时间 yyyy-MM-dd HH:mm:ss
refundTotalAmount Integer Y 退保保费总金额 单位分
cancelEntity Integer Y 退款主体 1-保司已退 2-需要苏宁退
cancelType Integer Y 退保类型 1-生效前撤单 2-犹豫期退保 3-退保 4-理赔解约
cancelReason String N 退保原因
extendMap map N 扩展待用字段
refundDetail Array Y 退款信息 期缴保单退保时必传
refundNo String N 退款单号
times Integer Y 退款对应期缴期次号 第一期传1,第二期传2,……
refundAmount Integer Y 退款金额 单位分
refundTime String N 退款时间 yyyy-MM-dd HH:mm:ss

请求报文示例

 {
  "policyNo": "2020030756015",
  "cancelTime": "2022-03-07 10:00:01",
  "refundTotalAmount": 10000000,
  "cancelEntity": 1,
  "cancelType": 1,
  "cancelReason": "没钱",
  "extendMap": {},
  "supplierCode": "S001",
  "refundDetail": [
    {
      "refundNo": "1000001",
      "times": 1,
      "refundAmount": 5000000,
      "refundTime": "2022-03-07 10:00:01"
    },
    {
      "refundNo": "1000002",
      "times": 2,
      "refundAmount": 5000000,
      "refundTime": "2022-03-07 10:00:01"
    }
  ]
} 

返回数据

字段 类型 必传 描述 说明
responseResult String Y 返回结果 json加密字符串
code String Y 解密后的处理成功标识 1.接收到推送数据处理成功,返回code=200;2.接收到推送数据处理失败,返回code!=200
message String N 解密后的处理失败原因

返回报文示例

{
  "responseResult": "C8A21B1142882A86BC466D7BBB2510DBE465F2CD877BB4215E16B59E0DBA6F74C01D0098183F860BAE3C931ABBDF33C2"
}

页面列表

ITEM_HTML