获取用户预投保信息

更新时间：2024.09.03

获取用户预投保信息，如用户实名ID、收益试算信息等

接口说明

支持商户：【普通商户】

请求方式：【GET】/v3/endowmentinsapi/preinsure-info/{preinsure_token}

请求域名：【主域名】https://pesion.weixin.qq.com.cn 使用该域名将访问就近的接入点

　　　　　【备域名】https:// 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

path 路径参数

preinsure_token 　必填 string(4096)

【预投保token】养老金小程序投保时会带给保司小程序

query 查询参数

ins_company_openid 　必填 string(128)

【保司小程序对应的用户OpenID】用户校验和token的信息是否一致

请求示例

1curl -X GET \
2  https://pesion.weixin.qq.com.cn/v3/endowmentinsapi/preinsure-info/TOKENABCDEFG?ins_company_openid=oUpF8uMuAJO_M2pxb1Q9zNjWeS6o \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

wesure_openid 　选填 string

【微保主站OpenID】用于微保主站系统

ins_user_id 　选填 string

【自然人脱敏ID】保司用于判断是否首投, 我们这边判断首投可能保司那边已有保单

first_insure_info 　选填 object

【收益试算信息】用于测算收益

属性

birthday 　选填 string

【出生日期】rfc3339所定义的full-date格式：yyyy-MM-DD

gender 　选填 string

【性别】性别

可选取值：

MALE: 男

FEMALE: 女

pension_info 　选填 object

【个养绑定信息】个养绑定信息

属性

bind_bank_name 　选填 string

【个养账户绑定的银行名称】个养账户绑定的银行名称

bank_logo 　选填 string

【银行logo url 链接】银行logo url 链接

bind_status 　选填 string

【个养绑定状态】个养绑定状态

可选取值：

BINDED: 已绑定

ENABLE_BIND: 未绑定可进行绑定

UNABLE_BIND: 未绑定且不可进行绑定

gray_status 　选填 string

【灰度状态】个养灰度状态

可选取值：

NOT_HIT_PENSION_GRAY: 未命中个养灰度

HIT_PENSION_GRAY: 命中个养灰度

setted_balance_info 　选填 boolean

【个养绑定银行是否设置了余额查询信息】个养绑定银行是否设置了余额查询信息

account_status 　选填 string

【个养账户状态】个养账户状态，ENABLE可用，DISABLE不可用

可选取值：

UNKNOWN: 未知值

ENABLE: 投保渠道可用（当前分微信支付投保渠道和个养投保渠道）

DISABLE: 投保渠道不可用（当前分微信支付投保渠道和个养投保渠道）

disable_reason 　选填 string

【个养账户不可用原因】个养账户不可用原因，当account_status为DISABLE时，该字段返回不可用原因用于展示文案

wxpay_channel_info 　选填 object

【用户微信支付投保渠道信息】用户微信支付投保渠道信息

属性

channel_status 　选填 string

【微信支付投保渠道是否可用状态】微信支付投保渠道是否可用状态

可选取值：

UNKNOWN: 未知值

ENABLE: 投保渠道可用（当前分微信支付投保渠道和个养投保渠道）

DISABLE: 投保渠道不可用（当前分微信支付投保渠道和个养投保渠道）

disable_reason 　选填 string

【微信支付投保渠道不可用原因】当channel_status为DISABLE时，该字段返回微信支付投保渠道不可用原因

应答示例

200 OK

1{
2  "wesure_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
3  "ins_user_id" : "f43371cce1c655c261856838d40d34fa762463eadfc4335a6f6079607941ed17",
4  "first_insure_info" : {
5    "birthday" : "2022-03-04",
6    "gender" : "MALE"
7  },
8  "pension_info" : {
9    "bind_bank_name" : "工商银行",
10    "bank_logo" : "https://gtimg.wechatpay.cn/resource/xres/img/202303/9325809e39761b1273d50c40c6d14cdc_128x128.png",
11    "bind_status" : "BINDED",
12    "gray_status" : "NOT_HIT_PENSION_GRAY",
13    "setted_balance_info" : false,
14    "account_status" : "UNKNOWN",
15    "disable_reason" : "暂无可投保的产品"
16  },
17  "wxpay_channel_info" : {
18    "channel_status" : "UNKNOWN",
19    "disable_reason" : "暂无可投保产品"
20  }
21}
22

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
429	RATE_LIMITED	请求超过频率限制	--
503	SYSTEM_ERROR	服务不可用，过载保护	--

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服