开发指引

微信保单服务支持代扣接入场景和主动支付接入场景。

• 商户在保险代扣预签约前，调用提交保单授权申请接口预先请求用户授权。用户签约完成后，微信支付将授权信息转为待授权状态，用户在微信支付客户端完成授权操作。

• 用户授权后，商户收到授权成功回调通知，或主动调用查询授权信息接口确认授权状态。确认已授权后，商户调用上传保单接口将保单详细信息同步至微信支付平台。

• 后续保单信息变更时（如出单成功、用户退保、保单失效等），商户需及时调用更新保单信息接口进行同步，可使用查询保单接口对账。

• 在提交保单授权申请后，如果保单关联新的保险代扣协议，商户需调用保单绑定保险代扣协议接口。

1. 商户调用提交保单授权申请接口，授权状态为初始态

2. 用户签约完成后，授权状态自动流转为待授权

3. 用户在微信支付客户端完成授权操作

4. 商户收到授权成功回调，或主动查询确认授权状态

• 车险：必须传递车牌信息

• 宠物险：必须传递宠物名称

在提交保单授权申请后，如果保单关联新的保险代扣协议，商户需调用保单绑定保险代扣协议接口。

若希望新的保险代扣协议的模板消息可跳转去查看保单，必须在保险代扣预签约前调用保单绑定保险代扣协议接口。

3.1、整体业务开发流程概览

• 商户在主动支付场景中，调用 JSAPI/小程序下单接口前，调用提交主动支付保单授权申请接口。微信支付在支付完成后，在支付完成页和支付凭证页展示用户授权入口。

• 用户授权后，商户收到授权成功回调通知，或调用查询主动支付保单授权信息接口确认授权状态。确认已授权后，商户调用上传主动支付保单接口将保单详细信息同步至微信支付平台。

• 后续保单信息变更时（如出单成功、用户退保、保单失效等），商户需及时调用更新主动支付保单信息接口进行同步，可使用查询主动支付保单接口对账。

3.2、详细步骤说明

3.2.1、商户提交主动支付保单授权申请

商户在调用 JSAPI/小程序下单接口前，调用提交主动支付保单授权申请接口预先请求用户授权。

若希望支付凭证页可跳转去查看保单，必须在JSAPI/小程序下单前提交主动支付保单授权申请。

授权流程：

1. 商户调用提交主动支付保单授权申请接口，授权状态为待授权

2. 用户在微信保单服务授权后，保单授权状态自动转为已授权

3. 商户收到授权成功回调，或主动查询确认授权状态

未收到回调时，商户可调用查询主动支付保单授权信息接口确认授权状态。

注意事项：

1. 接口必传用户openid

2. 必须在下单成功前提交授权申请

3. 只要用户授权，保单授权信息自动转为已授权并回调通知商户（包括未支付成功保单）

3.2.2、商户上传主动支付保单

用户授权后，商户调用上传主动支付保单接口将保单详细信息同步至微信支付平台。

续保配置规则：

若支持续保，续保开始时间不得晚于保障期结束前60天。

特殊保单类型：

• 车险：必须传递车牌信息

• 宠物险：必须传递宠物名称

上传保单成功后，授权状态流转为已失效。

3.2.3、商户更新保单

保单信息变更时，商户调用更新主动支付保单信息接口实时同步。

• 当保单状态为已承保或已失效时，需传递保司保单号

• 商户应及时同步保单状态变更，确保信息一致性

3.2.4、商户对账

商户可通过查询主动支付保单接口定期获取保单信息，与商户系统内信息进行核对。

4.1、整体业务开发流程概览

4.2、详细步骤说明

4.2.1、商户上传设置保单权益

1. 需在上传保单成功后调用

2. 同一保单可设置多条权益，通过权益枚举值区分不同类型

3. 权益信息变更时，需及时调用本接口同步

4.2.2、商户查询设置保单权益

1. 返回该保单下所有权益记录

2. 支持分页查询