最新更新时间:2022.5.20 版本说明
商户可通过调用此接口,提交内容回复用户。其中上传图片凭证需首先调用商户上传反馈图片接口,得到图片id,再将id填入请求。 回复可配置文字链,传入跳转链接文案和跳转链接字段,用户点击即可跳转对应页面。
首次回复用户后,投诉单状态将由待处理更新为处理中。
适用对象:直连商户
请求URL:https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2/{complaint_id}/response
请求方式:POST
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
投诉单号 | complaint_id | string[1, 64] | 是 | path投诉单对应的投诉单号 示例值:200201820200101080076610000 |
被诉商户号 | complainted_mchid | string[1, 64] | 是 | body投诉单对应的被诉商户号 示例值:1900012181 |
回复内容 | response_content | string[1, 200] | 是 | body具体的投诉处理方案,限制200个字符以内。 示例值:已与用户沟通解决 |
回复图片 | response_images | array | 否 | body传入调用商户上传反馈图片接口返回的media_id,最多上传4张图片凭证 示例值:["aabbccdd","aaccddee"] |
跳转链接 | jump_url | string[1, 512] | 否 | body商户可在回复中附加跳转链接,引导用户跳转至商户客诉处理页面,链接需满足https格式 注:配置文字链属于灰度功能, 若有需要请使用超管邮箱,按照要求发送邮件申请。邮件要求详情见: 商户申请开通留言链接白名单指南。 示例值:https://www.xxx.com/notify |
跳转链接文案 | jump_url_text | string[1, 10] | 否 | body实际展示给用户的文案,附在回复内容之后。用户点击文案,即可进行跳转。 注:若传入跳转链接,则跳转链接文案为必传项,二者缺一不可。 示例值:查看订单详情 |
{
"complainted_mchid": "1900012181",
"response_content": "已与用户沟通解决",
"jump_url": "https://www.xxx.com/notify",
"jump_url_text": "查看订单详情",
"response_images": ["aabbccdd","aaccddee"]
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 参数错误 | 请根据错误提示,传入正确参数 |
400 | INVALID_REQUEST | 请求参数符合参数格式,但不符合业务规则项 | 请确认参数符合业务要求,稍后重新调用 |
401 | SIGN_ERROR | 签名验证失败 | 请检查签名参数和方法是否都符合签名算法要求 |
403 | NO_AUTH | 无权限 | 请开通商户号权限,并确认参数符合规范 |
429 | FREQUENCY_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |