开通保险理赔功能

更新时间：2024.11.18

平台服务商可通过该接口为保险公司开通保险理赔功能。

接口说明

支持商户：【平台商户】　【普通服务商】

请求方式：【POST】/v3/platsolution/ecommerce/insurance-compensation-contracts

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

body 包体参数

out_apply_no 　必填 string(32)

【商户申请单号】需保证在业务方系统内唯一，只能是数字、大小写字母

sub_mchid 　必填 string(32)

【二级商户号】需开通保险理赔功能的保险公司商户号

agreement_list 　必填 array[Agreement]

【签约协议列表】签约协议列表

属性

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/platsolution/ecommerce/insurance-compensation-contracts \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_apply_no" : "No123456",
8    "sub_mchid" : "1900000109",
9    "agreement_list" : [
10      {
11        "agreement_code" : "微信支付运营功能服务协议（平台二级商户）",
12        "agreement_version" : "20240815",
13        "sign_organization" : "温州名优贸易",
14        "sign_time" : "2024-08-08T10:34:56+08:00"
15      }
16    ]
17  }'
18

应答参数

200 OK

sub_mchid 　必填 string(32)

【二级商户号】保险公司的商户号

opened 　必填 boolean

【是否开通成功】保险理赔功能的开通结果

开通成功：true
开通失败：false

success_time 　选填 string(64)

【成功时间】开通成功时返回，时间格式遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。

应答示例

200 OK

1{
2  "sub_mchid" : "1900000109",
3  "opened" : true,
4  "success_time" : "2024-08-09T13:29:35.120+08:00"
5}
6

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	此错误表示本次开通保险理赔功能失败，请根据具体的错误提示做相应处理
400	ALREADY_EXISTS	产品功能已经开通，请勿重复开通	请勿重试
403	NO_AUTH	产品权限异常，请检查	请确认是否已经开通相关权限，检查权限是否被处罚
429	FREQUENCY_LIMITED	频率限制	请降低频率后重试

文档是否有帮助

更多支持

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