更新日志

2026.09.21

V0.0.15版本

更新接口描述

• 《提交保单授权申请》保单关联协议号发生变更（重新签约 / 保费批改）时，必须调用保单绑定保险代扣协议接口做绑定，否则代扣模板消息不展示保单服务入口。

• 《上传保单》增加签约协议号填写约束：限定需传最终签约成功协议号、协议号需已绑定保单、协议号 openid 与请求 openid 保持一致；更换协议号需调用保单绑定保险代扣协议接口完成绑定。

2026.09.14

V0.0.14版本

• 《提交主动支付保单授权申请》、《查询主动支付保单授权信息》、《查询保单授权信息》、《提交保单授权申请》返回参数新增 feedback_reason （保单反馈原因）字段。

• 新增《查询超时未上传保单原因》。

• 更新《开发指引》。

2026.08.15

V0.0.13版本

• 更新《跳转到商户小程序保单详情页》。

2026.08.14

V0.0.12版本

• 代扣场景和主动支付场景，支持保单跨主体传入，即上传方商户号和收款方商户号不同的情况，包括以下接口：

  • 提交主动支付保单授权申请

  • 上传主动支付保单

  • 提交保单授权申请

  • 上传保单

  • 添加保单-协议绑定

2026.07.21

V0.0.11版本

• 支持保单权益接入

  • 更新开发指引

  • 新增设置保单权益

  • 新增查询保单权益

  • 新增跳转到商户小程序保单权益页

2026.06.23

V0.0.10版本

• 原API列表中代扣接入场景的文档移到【代扣接入场景】目录下。

• 新增主动支付接入场景的接口在【主动支付接入场景】目录下，包括以下接口：

  • 提交主动支付保单授权申请

  • 查询主动支付保单授权信息

  • 用户授权结果通知

  • 上传主动支付保单

  • 更新主动支付保单信息

  • 查询主动支付保单

• 更新《开发指引》，增加主动支付接入场景使用说明。

• 更新《保单状态转移矩阵和枚举值说明》，增加保单状态转移矩阵补充说明。

• 更新《保险公司代码-名称映射表》，增加保险公司简称。

2026.06.05

V0.0.9版本

• 《上传保单》《更新保单信息》请求和响应参数新增字段：coverage_term_type（保障期限类型）

• 《查询保单》响应参数新增字段：coverage_term_type（保障期限类型）

• 《上传保单》《更新保单信息》请求参数变更：start_renewal_time 移除不早于保障期结束前60天约束

2026.04.22

V0.0.8版本

• 《上传保单》《更新保单信息》请求和响应参数新增字段：freeinsurance（是否为赠险）、combinedpayment（是否与其它保单合并扣费）、paymentmethod（缴费方式）、periodpremiummode（期交保费模式）、paymentperiod（缴费周期）、firstperiodamount（首期保费金额）、subsequentperiodamount（后续每期保费金额）。

• 《上传保单》请求参数变更： policy_periods 移除必传约束及 minItems=1 限制。（未来计划废弃该字段）

• 《查询保单》响应参数新增字段：freeinsurance（是否为赠险）、combinedpayment（是否与其它保单合并扣费）、paymentmethod（缴费方式）、periodpremiummode（期交保费模式）、paymentperiod（缴费周期）、firstperiodamount（首期保费金额）、subsequentperiodamount（后续每期保费金额）。

2026.04.03

V0.0.7版本

• 《上传保单》《更新保单信息》请求和响应参数coverage_detail，《查询保单》响应参数coverage_detail，字段长度调整成1000字符&描述更新。

• 《提交保单授权申请》《查询保单授权信息》《用户授权结果通知》授权状态枚举【已失效】AUTH_STATE_EXPIRED描述去掉“商户超过30天未上传保单转为失效”。

• 《上传保单》去掉上传保单时间限制。

2026.03.27

V0.0.6版本

《查询保单》《更新保单信息》《上传保单》更新返回参数 policy_periods ，字段可选性由必填改为选填。

2026.03.20

V0.0.5版本

《添加保单-协议绑定》标题已更新为《保单绑定保险代扣协议》，同时完成接口描述优化；《开发指引》已更新。

2026.03.12

V0.0.4版本

• 更新《开发指引》《提交保单授权申请》提交保单授权申请接口去掉提交窗口期（签约成功后2h内）限制；支持存量保单代扣协议(生效中或已解约)提交保单授权申请。

• 新增接口文档《添加保单-协议绑定》。

2026.01.30

V0.0.3版本

优化文档描述

2026.01.14

V0.0.2版本

新增开发指引，优化文档描述

2025.12.23

V0.0.1版本

初始版本(预研使用)