退保信息推送
接口概述
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:加密字符串}
请求数据
字段 | 类型 | 必传 | 描述 | 说明 |
---|---|---|---|---|
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"
}