保险商户受理续期自动续费协议
更新时间:2024.12.26商户可通过本接口续期保险自动续费协议。
前置条件:用户签约成功,当协议到期后且预签约中参数是否自动续保(can_auto_insure)或是否自动重新投保(can_auto_reinsure)为true。当前仅支持续期后的扣费金额波动不能超过原最后一期金额的50%,大于此波动会报错。
# 接口说明
支持商户:
【普通商户】
请求方式:
【POST】/v3/papay/insurance-sign/contracts/plan-id/{plan_id}/contract-id/{contract_id}/renew
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看
# 请求参数
- Authorization 必填请参考 签名认证 生成认证信息
- Accept 必填请设置为
application/json
- Content-Type 必填请设置为
application/json
Header HTTP头参数
- plan_id 必填【委托代扣模板ID】 委托代扣模板ID,申请见接入指引中的接入流程相关内容。
- contract_id 必填【委托代扣协议ID】 签约成功后,微信返回的委托代扣协议ID
Path 路径参数
- appid 必填【应用ID】 商户在微信申请的公众号或移动应用AppID
- policy_periods 必填【续期的扣费周期列表】 续期的扣费周期列表,每次续期的扣费期总量需大于等于1且小于等于12。续期的第一期扣费期数必须大于当前扣费周期列表的最后一期。后续需要按照周期中的预计扣款时间和预计扣款金额进行预约扣款和扣款。预计扣款时间需要随着编号的递增而递增,编号较大的预计扣款时间不能早于编号较小的预计扣款时间。相邻编号的预计扣费时间间隔需要匹配委托代扣模板ID指定的扣费频率。
- 属性
Body 包体参数
请求示例
POST
# 应答参数
无应答包体
应答示例
204 No Content
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
# 业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | INVALID_REQUEST | 无效请求 | 请根据接口返回的详细信息检查您的程序 |
403 | NO_AUTH | 商户暂无权限使用此功能 | 请开通商户号权限。请联系产品或商务申请 |
429 | FREQUENCY_LIMITED | 频率超限 | 请降低请求接口频率 |
500 | SYSTEM_ERROR | 接口返回错误 | 系统异常,请用相同参数重新调用 |
文档是否有帮助