查询保单
更新时间:2026.01.14商户通过商户保险编号获取在微信支付侧同步的保单信息 。
● 信息对账:商户应定期通过此接口,核对微信支付平台记录的保单信息与商户系统内是否一致。
接口说明
支持商户:【普通商户】
请求方式:【GET】/v3/inspolicymgr/deduct/policies/{out_insurance_no}
请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点
【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看
请求参数
Header HTTP头参数
Authorization 必填 string
请参考签名认证生成认证信息
Accept 必填 string
请设置为application/json
path 路径参数
out_insurance_no 必填 string(32)
【商户保险编号】 商户侧的保单唯一值,商户自定义字段,商户侧需保证该商户号下的唯一性。只能是数字、大小写字母的组合。字段作为整个保单管理流程的保单的唯一标识
请求示例
GET
应答参数
200 OK
out_insurance_no 必填 string(32)
【商户保险编号】 商户侧的保单唯一值,商户自定义字段,商户侧需保证该商户号下的唯一性。只能是数字、大小写字母的组合。字段作为整个保单管理流程的保单的唯一标识
insurance_name 必填 string(50)
【保险名称】 用户投保的保险名称,用于展示给用户
insured_name_list 必填 array[string(1024)]
【被保险人姓名列表】 被保险人姓名全称:单被保人时传入对应的姓名,多被保人时传入数组,最多允许传入11人;字段为密文,解密请参考如何使用API证书解密敏感字段。
insurance_company_code 必填 string(32)
【承保公司代码】 微信保单服务为承保保险公司分配的唯一标识。请通过保险公司代码-名称映射表获取保险公司代码与最新名称。
effective_time 必填 string(25)
【保单生效时间】 标识保单保障期的起始时刻,从该时刻起(含边界)保单处于保障中状态。遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。 示例:2025-05-20T13:29:35+08:00 表示北京时间2025年5月20日13点29分35秒。
expired_time 必填 string(25)
【保单失效时间】 标识保单保障期的结束时刻,在该时刻之前(不含边界)保单处于保障中状态。遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。 示例:2025-05-20T13:29:35+08:00 表示北京时间2025年5月20日13点29分35秒。必须满足:保单失效时间大于保单生效时间: expired_time > effective_time
coverage_detail 必填 string(60)
【保障详情】 保险对应的保障责任简述,最多支持输入60个字符
support_renewal 必填 boolean
【是否支持续保】 标识该保单是否支持续保功能
start_renewal_time 选填 string(25)
【可续保开始时间】 标识续保窗口的起始时刻,从该时刻起(含边界)允许发起续保。遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。 示例:2025-05-20T13:29:35+08:00 表示北京时间2025年5月20日13点29分35秒。必须满足:(1)支持续保(support_renewal=true)时必填 (2)位于保障期内:effective_time < start_renewal_time ≤ expired_time (3)不早于保障期结束前60天:start_renewal_time ≥ expired_time − 60天。
end_renewal_time 选填 string(25)
【可续保结束时间】 标识续保窗口的结束时刻,在该时刻之前(不含边界)允许发起续保。遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。 示例:2025-05-20T13:29:35+08:00 表示北京时间2025年5月20日13点29分35秒。必须满足:(1)支持续保(support_renewal=true)时必填 (2)大于可续保开始时间: end_renewal_time > start_renewal_time (3)不晚于保障期结束时间后60天: end_renewal_time ≤ expired_time + 60天。
policy_type 必填 string
【保单类型】 保单类型
可选取值
POLICY_TYPE_OTHER: 其余险POLICY_TYPE_MEDICAL: 医疗险POLICY_TYPE_ACCIDENT: 意外险POLICY_TYPE_CRITICAL: 重疾险POLICY_TYPE_CAR: 车险POLICY_TYPE_LIFE: 人寿险POLICY_TYPE_PROPERTY: 家财险POLICY_TYPE_PET: 宠物险POLICY_TYPE_ANNUITY: 年金险
car_number 选填 string(10)
【车牌信息】 保单类型为车险(policy_type=POLICY_TYPE_CAR)时,返回
pet_name 选填 string(10)
【宠物名称】 保单类型为宠物险(policy_type=POLICY_TYPE_PET)时,如果有传入,则返回
address 选填 string(300)
【地址信息】 保单类型为家财险(policy_type=POLICY_TYPE_PROPERTY)时,如果有传入,则返回
policy_state 必填 string
【保单状态】 商户上传或更新的保单状态
可选取值
POLICY_STATE_ISSUING: 【出单中】正在进行出单操作,保险公司还未通过承保请求POLICY_STATE_APPROVED: 【已承保】保险公司已承保,保单处于保障待生效或保障中状态POLICY_STATE_DECLINED: 【拒保】保险公司拒绝承保或出单失败POLICY_STATE_INACTIVE: 【已失效】因各种问题,保单失效(用户退保、保单到期、欠费失效、理赔额度用尽等)
policy_code 选填 string(64)
【保司保单号】 保司承保后,为用户保单分配的唯一标识。保单状态为已承保、已失效时,返回。
plan_id 必填 string
【保险委托代扣模板ID】 是商户在微信支付保险委托代扣平台申请模板
out_contract_code 必填 string(32)
【商户签约协议号】 商户侧的签约协议号,商户自定义字段,商户侧需保证唯一性。只能是数字、大小写字母的组合。
policy_periods 必填 array[integer]
【保单的扣费周期列表】 商户在与用户签约时,指定的若干个扣费周期。要求:扣费编号需要与创建签约的保持一致。
应答示例
200 OK
错误码
以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

