同步退保信息

更新时间：2024.08.29

同步退保信息，线下退保成功事件也会调用此接口，但线下用户申请退保、保司同意退保等事件一期暂不会调用

接口说明

支持商户：【普通商户】

请求方式：【POST】/v3/endowmentinsapi/policies/{ins_policy_no}/surrender-receipts/{surrender_id}/sync

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

path 路径参数

surrender_id 　必填 string

【退保单据ID】退保单据ID

ins_policy_no 　必填 string

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

body 包体参数

wesure_policy_no 　选填 string

【微保侧保单的单号】微保侧保单的单号

surrender_state 　选填 string

【退保单据状态】退保单据状态

可选取值：

APPLY: 用户申请退保

AGREE: 保司同意退保

REFUND: 退款成功

REVOKE: 用户撤销

REJECT: 保司驳回

surrender_amount 　选填 integer

【退保金额】退保金额

surrender_source 　选填 string

【退保来源】退保来源

可选取值：

ONLINE_INS_MP: 从养老金小程序入口申请退保

OFFLINE_OUTLETS: 线下网点申请退保

INS_COMPANY_MP: 保司小程序申请退保

INS_COMPANY_PUB_MP: 保司公众号申请退保

refund_channel 　选填 string

【退款渠道】退款渠道

可选取值：

BALANCE: 零钱

BANK_CARD: 银行卡

PENSION_ACCOUNT: 个养账户

ORIGINAL: 当前犹豫期内退保默认都为原路退回方式

MULTI_CHANNEL: 犹豫期内退保原路退回，存在部分投入单原路退回失败的情况

surrender_apply_time 　选填 string

【用户申请退保时间】用户申请退保时间，使用rfc3339所定义的date-time格式

surrender_agree_time 　选填 string

【保司同意退保时间】结案时必填，使用rfc3339所定义的date-time格式

surrender_finish_time 　选填 string

【退保结束时间】退款完成、驳回、撤销时必填，使用rfc3339所定义的date-time格式

ins_company_openid 　选填 string

【退保申请人在保司下的OpenID】养老金入口操作时必填

refund_order_list 　选填 array[SurrenderReceiptRefundOrder]

【退款单信息】状态为退款成功时传入

属性

bank_card_info 　选填 object

【银行卡信息】退款渠道为银行卡时传入

属性

outlets_info 　选填 object

【线下网点信息】退保入口为线下网点时传入

	属性
	name 　选填 string 【网点名称】网点名称

surrender_fund_info 　选填 object

【退保明细展示信息，犹豫期外退保需要带上该信息】退保明细展示信息，犹豫期外退保需要带上该信息

属性

premium_id_list 　选填 array[PremiumIdInfo]

【原投入保费信息列表】当前同步退保接口会带上该保单的所有原投入单业务单号（使用场景：1、犹豫期内原路退回退保资金明细需要关联原单；2、犹豫期内原路退回失败，退保退款到账的时候需要将原投入保费资金明细设置为已退保退款，关联的多条退保资金明细需要设置为无效）

	属性
	premium_id 　选填 string 【投入保费业务单号】退保的场景下，用户原投入保费的业务单号

请求示例

1curl -X POST \
2  https://pesion.weixin.qq.com.cn/v3/endowmentinsapi/policies/INSPOLICYNO/surrender-receipts/SURRENDERID/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    "surrender_state" : "APPLY",
9    "surrender_amount" : 200000,
10    "surrender_source" : "ONLINE_INS_MP",
11    "refund_channel" : "BALANCE",
12    "surrender_apply_time" : "2020-12-01T16:18:12+08:00",
13    "surrender_agree_time" : "2020-12-01T16:18:12+08:00",
14    "surrender_finish_time" : "2020-12-01T16:18:12+08:00",
15    "ins_company_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
16    "refund_order_list" : [
17      {
18        "refund_no" : "50300605482023051034258486261",
19        "refund_finish_time" : "2020-12-01T16:18:12+08:00",
20        "origin_premium_id" : "2923051036411828016822142030"
21      }
22    ],
23    "bank_card_info" : {
24      "bank_no" : "CBC_DEBIT",
25      "card_tail_num" : "1234"
26    },
27    "outlets_info" : {
28      "name" : "粤海街道网点"
29    },
30    "surrender_fund_info" : {
31      "premium_surrender_rate" : 9500,
32      "income_surrender_rate" : 9500,
33      "policy_year" : 0,
34      "total_premium" : 10000,
35      "total_income" : 10000
36    },
37    "premium_id_list" : [
38      {
39        "premium_id" : "2923051053753173317841142183"
40      }
41    ]
42  }'
43

应答参数

无应答包体

应答示例

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版)开发者社区微信开放平台微信公众平台腾讯客服