回复用户

更新时间：2024.09.20

商户可通过调用此接口，提交内容回复用户。其中上传图片凭证需首先调用商户上传反馈图片接口，得到图片id，再将id填入请求。
回复可配置文字链，传入跳转链接文案和跳转链接字段，用户点击即可跳转对应页面。

首次回复用户后，投诉单状态将由待处理更新为处理中。

接口说明

支持商户：【普通商户】

请求方式：【POST】/v3/merchant-service/complaints-v2/{complaint_id}/response

请求域名：【主域名】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

path 路径参数

complaint_id 　必填 string(64)

【投诉单号】投诉单对应的投诉单号

body 包体参数

complainted_mchid 　必填 string(64)

【被诉商户号】投诉单对应的被诉商户号

response_content 　必填 string(200)

【回复内容】具体的投诉处理方案，限制200个字符以内。

response_images 　选填 array[string]

【回复图片】传入调用“商户上传反馈图片”接口返回的media_id，最多上传4张图片凭证

jump_url 　选填 string(512)

【跳转链接】商户可在回复中附加跳转链接，引导用户跳转至商户客诉处理页面，链接需满足HTTPS格式。注：配置文字链属于灰度功能，若有需要请联系对接的行业运营进行咨询。

jump_url_text 　选填 string(10)

【跳转链接文案】实际展示给用户的文案，附在回复内容之后。用户点击文案，即可进行跳转。
注：若传入跳转链接，则跳转链接文案为必传项，二者缺一不可。

mini_program_jump_info 　选填 MiniProgramJumpInfo

【跳转小程序信息】 商户可在回复中附加小程序信息，引导用户跳转至商户客诉处理小程序。注：配置小程序属于灰度功能，若有需要请联系对接的行业运营进行咨询。

属性

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2/200201820200101080076610000/response \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "complainted_mchid" : "1900012181",
8    "response_content" : "已与用户沟通解决",
9    "response_images" : [
10      "aabbccdd"
11    ],
12    "jump_url" : "https://www.xxx.com/notify",
13    "jump_url_text" : "查看订单详情",
14    "mini_program_jump_info" : {
15      "appid" : "example_appid",
16      "path" : "example_path",
17      "text" : "example_text"
18    }
19  }'
20

应答参数

无应答包体

应答示例

204 No Content

1'无应答包体'
2

错误码

公共错误码

状态码	错误码	描述	解决方案
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	系统错误	5开头的状态码都为系统问题，请使用相同参数稍后重新调用

文档是否有帮助

更多支持

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