同步定期投入相关消息

更新时间：2024.08.29

同步定期投入相关消息，如养老金按期投入预告通知、养老金定期投入失败通知

接口说明

支持商户：【普通商户】

请求方式：【POST】/v3/endowmentinsapi/policies/{ins_policy_no}/regular-add-plans/{regular_add_id}/message/sync

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

path 路径参数

ins_policy_no 　必填 string(128)

【养老金保单号】养老金保单号

regular_add_id 　必填 string

【定期投计划ID】定期投计划ID

body 包体参数

wesure_policy_no 　选填 string

【微保公司保单号】微保公司保单号

ins_company_openid 　选填 string

【用户在保司小程序的OpenID】用户在保司小程序的OpenID

message_type 　选填 string

【定期投入消息类型】定期投入消息类型

可选取值：

FIRST_ADD_REMIND: 养老金按期投入首次预告

FIRST_ADD_FAIL_NOTICE: 养老金按期投入首次失败通知

NEXT_ADD_REMIND: 养老金按期投入再次预告

FINAL_ADD_FAIL_NOTICE: 养老金按期投入最终失败通知

add_premium 　选填 integer

【定期投入保费金额】定期投入保费金额，单位为分

add_period 　选填 string

【定期投入周期】定期投入周期

可选取值：

MONTH: 月

YEAR: 年

add_start_time 　选填 string

【定期投入开始时间】定期投入开始时间，使用rfc3339所定义的date-time格式

next_add_time 　选填 string

【下期投入时间】消息类型为按期投入预告时必填，使用rfc3339所定义的date-time格式

add_fail_time 　选填 string

【定期投入失败时间】消息类型为按期投入失败时必填，使用rfc3339所定义的date-time格式

aml_collect_flag 　选填 string

【反洗钱信息收集标记】反洗钱信息收集标记

可选取值：

NOT_COLLECTED: 未收集

COLLECTED: 已收集

add_fail_type 　选填 string

【定期投入失败类型】定期投入失败类型，定期投入失败时必填

可选取值：

AML_INTERCEPT: 反洗钱拦截

DEDUCTION_FAIL: 代扣失败

OTHER_TYPE: 其他类型

HIT_QUOTA: 命中年投保限额

DEDUCTION_NOT_ENOUGH: 余额不足，代扣失败

INS_COMPANY_SYSTEM: 保司系统维护

TERMINATE: 暂停/修改/关闭定期计划

POLICY_LAPSE: 保单已失效（非 PLCK_OK）

regular_add_invest_id 　选填 string

【定期投交费期次id】定期投交费期次id，在所有交费期次里面保障唯一

next_pay_time 　选填 string

【下一次扣费时间】下一次扣费时间，使用rfc3339所定义的date-time格式

regular_add_remain_times 　选填 integer

【剩余的可添加定期投的次数】剩余的可添加定期投的次数

continuous_deduction_fail_times 　选填 integer

【当前定期投连续扣费失败期数】当前定期投连续扣费失败期数

请求示例

1curl -X POST \
2  https://pesion.weixin.qq.com.cn/v3/endowmentinsapi/policies/INSPOLICYNO/regular-add-plans/REGULARADDID/message/sync \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "wesure_policy_no" : "WESUREPOLICYNO",
8    "ins_company_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
9    "message_type" : "FIRST_ADD_REMIND",
10    "add_premium" : 10000,
11    "add_period" : "MONTH",
12    "add_start_time" : "2020-12-01T16:18:12+08:00",
13    "next_add_time" : "2020-12-01T16:18:12+08:00",
14    "add_fail_time" : "2020-12-01T16:18:12+08:00",
15    "aml_collect_flag" : "NOT_COLLECTED",
16    "add_fail_type" : "AML_INTERCEPT",
17    "regular_add_invest_id" : "2923030763943365003853142009",
18    "next_pay_time" : "2020-12-01T16:18:12+08:00",
19    "regular_add_remain_times" : 3,
20    "continuous_deduction_fail_times" : 1
21  }'
22

应答参数

无应答包体

应答示例

204 No Content

1'无应答包体'
2

错误码

公共错误码

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

业务错误码

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

文档是否有帮助

更多支持

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