查询投诉单列表
更新时间:2025.08.28商户可通过调用此接口,查询指定时间段的所有用户投诉信息,以分页输出查询结果。对于服务商、渠道商,可通过调用此接口,查询指定特约商户号下的投诉信息,若不指定,则查询的是名下所有特约商户投诉信息。
接口说明
支持商户:【普通商户】
请求方式:【GET】/v3/merchant-service/complaints-v2
请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点
【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看
请求参数
Header HTTP头参数
Authorization 必填 string
请参考签名认证生成认证信息
Accept 必填 string
请设置为application/json
query 查询参数
limit 选填 integer
【分页大小】 设置该次请求返回的最大投诉条数,范围[1,50]
offset 选填 integer
【分页开始位置】 该次请求的分页开始位置,从0开始计数,例如offset=10,表示从第11条记录开始返回。
begin_date 必填 string(10)
【开始日期】 投诉发生的开始日期。注意,查询日期跨度不超过30天
end_date 必填 string(10)
【结束日期】 投诉发生的结束日期。注意,查询日期跨度不超过30天
complainted_mchid 选填 string(64)
【被诉商户号】 投诉单对应的被诉商户号。当服务商或渠道商查询指定子商户的投诉信息时按需传入,不传则可以查询名下所有子商户的投诉
请求示例
GET
1curl -X GET \ 2 https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2?limit=5&offset=10&begin_date=2019-01-01&end_date=2019-01-01&complainted_mchid=1900012181 \ 3 -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \ 4 -H "Accept: application/json" 5
需配合微信支付工具库 WXPayUtility 使用,请参考Java
1package com.java.demo; 2 3import com.java.utils.WXPayUtility; // 引用微信支付工具库,参考:https://pay.weixin.qq.com/doc/v3/merchant/4014931831 4 5import com.google.gson.annotations.SerializedName; 6import com.google.gson.annotations.Expose; 7import okhttp3.MediaType; 8import okhttp3.OkHttpClient; 9import okhttp3.Request; 10import okhttp3.RequestBody; 11import okhttp3.Response; 12 13import java.io.IOException; 14import java.io.UncheckedIOException; 15import java.security.PrivateKey; 16import java.security.PublicKey; 17import java.util.ArrayList; 18import java.util.HashMap; 19import java.util.List; 20import java.util.Map; 21 22/** 23 * 查询投诉单列表 24 */ 25public class ListComplaintsV2 { 26 private static String HOST = "https://api.mch.weixin.qq.com"; 27 private static String METHOD = "GET"; 28 private static String PATH = "/v3/merchant-service/complaints-v2"; 29 30 public static void main(String[] args) { 31 // TODO: 请准备商户开发必要参数,参考:https://pay.weixin.qq.com/doc/v3/merchant/4013070756 32 ListComplaintsV2 client = new ListComplaintsV2( 33 "19xxxxxxxx", // 商户号,是由微信支付系统生成并分配给每个商户的唯一标识符,商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/merchant/4013070756 34 "1DDE55AD98Exxxxxxxxxx", // 商户API证书序列号,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013053053 35 "/path/to/apiclient_key.pem", // 商户API证书私钥文件路径,本地文件路径 36 "PUB_KEY_ID_xxxxxxxxxxxxx", // 微信支付公钥ID,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816 37 "/path/to/wxp_pub.pem" // 微信支付公钥文件路径,本地文件路径 38 ); 39 40 ListComplaintsV2Request request = new ListComplaintsV2Request(); 41 request.limit = 5L; 42 request.offset = 10L; 43 request.beginDate = "2019-01-01"; 44 request.endDate = "2019-01-01"; 45 request.complaintedMchid = "1900012181"; 46 try { 47 ListComplaintsV2Response response = client.run(request); 48 // TODO: 请求成功,继续业务逻辑 49 System.out.println(response); 50 } catch (WXPayUtility.ApiException e) { 51 // TODO: 请求失败,根据状态码执行不同的逻辑 52 e.printStackTrace(); 53 } 54 } 55 56 public ListComplaintsV2Response run(ListComplaintsV2Request request) { 57 String uri = PATH; 58 Map<String, Object> args = new HashMap<>(); 59 args.put("limit", request.limit); 60 args.put("offset", request.offset); 61 args.put("begin_date", request.beginDate); 62 args.put("end_date", request.endDate); 63 args.put("complainted_mchid", request.complaintedMchid); 64 String queryString = WXPayUtility.urlEncode(args); 65 if (!queryString.isEmpty()) { 66 uri = uri + "?" + queryString; 67 } 68 69 Request.Builder reqBuilder = new Request.Builder().url(HOST + uri); 70 reqBuilder.addHeader("Accept", "application/json"); 71 reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId); 72 reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo, privateKey, METHOD, uri, null)); 73 reqBuilder.method(METHOD, null); 74 Request httpRequest = reqBuilder.build(); 75 76 // 发送HTTP请求 77 OkHttpClient client = new OkHttpClient.Builder().build(); 78 try (Response httpResponse = client.newCall(httpRequest).execute()) { 79 String respBody = WXPayUtility.extractBody(httpResponse); 80 if (httpResponse.code() >= 200 && httpResponse.code() < 300) { 81 // 2XX 成功,验证应答签名 82 WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey, 83 httpResponse.headers(), respBody); 84 85 // 从HTTP应答报文构建返回数据 86 return WXPayUtility.fromJson(respBody, ListComplaintsV2Response.class); 87 } else { 88 throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers()); 89 } 90 } catch (IOException e) { 91 throw new UncheckedIOException("Sending request to " + uri + " failed.", e); 92 } 93 } 94 95 private final String mchid; 96 private final String certificateSerialNo; 97 private final PrivateKey privateKey; 98 private final String wechatPayPublicKeyId; 99 private final PublicKey wechatPayPublicKey; 100 101 public ListComplaintsV2(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) { 102 this.mchid = mchid; 103 this.certificateSerialNo = certificateSerialNo; 104 this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath); 105 this.wechatPayPublicKeyId = wechatPayPublicKeyId; 106 this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath); 107 } 108 109 public static class ListComplaintsV2Request { 110 @SerializedName("limit") 111 @Expose(serialize = false) 112 public Long limit; 113 114 @SerializedName("offset") 115 @Expose(serialize = false) 116 public Long offset; 117 118 @SerializedName("begin_date") 119 @Expose(serialize = false) 120 public String beginDate; 121 122 @SerializedName("end_date") 123 @Expose(serialize = false) 124 public String endDate; 125 126 @SerializedName("complainted_mchid") 127 @Expose(serialize = false) 128 public String complaintedMchid; 129 } 130 131 public static class ListComplaintsV2Response { 132 @SerializedName("data") 133 public List<ComplaintInfo> data; 134 135 @SerializedName("limit") 136 public Long limit; 137 138 @SerializedName("offset") 139 public Long offset; 140 141 @SerializedName("total_count") 142 public Long totalCount; 143 } 144 145 public static class ComplaintInfo { 146 @SerializedName("complaint_id") 147 public String complaintId; 148 149 @SerializedName("complaint_time") 150 public String complaintTime; 151 152 @SerializedName("complaint_detail") 153 public String complaintDetail; 154 155 @SerializedName("complaint_state") 156 public String complaintState; 157 158 @SerializedName("payer_phone") 159 public String payerPhone; 160 161 @SerializedName("complaint_order_info") 162 public List<ComplaintOrderInfo> complaintOrderInfo; 163 164 @SerializedName("complaint_full_refunded") 165 public Boolean complaintFullRefunded; 166 167 @SerializedName("incoming_user_response") 168 public Boolean incomingUserResponse; 169 170 @SerializedName("user_complaint_times") 171 public Long userComplaintTimes; 172 173 @SerializedName("complaint_media_list") 174 public List<ComplaintMedia> complaintMediaList; 175 176 @SerializedName("problem_description") 177 public String problemDescription; 178 179 @SerializedName("problem_type") 180 public ProblemType problemType; 181 182 @SerializedName("apply_refund_amount") 183 public Long applyRefundAmount; 184 185 @SerializedName("user_tag_list") 186 public List<UserTag> userTagList; 187 188 @SerializedName("service_order_info") 189 public List<ServiceOrderInfo> serviceOrderInfo; 190 191 @SerializedName("additional_info") 192 public AdditionalInfo additionalInfo; 193 194 @SerializedName("in_platform_service") 195 public Boolean inPlatformService; 196 197 @SerializedName("need_immediate_service") 198 public Boolean needImmediateService; 199 } 200 201 public static class ComplaintOrderInfo { 202 @SerializedName("transaction_id") 203 public String transactionId; 204 205 @SerializedName("out_trade_no") 206 public String outTradeNo; 207 208 @SerializedName("amount") 209 public Long amount; 210 } 211 212 public static class ComplaintMedia { 213 @SerializedName("media_type") 214 public ComplaintMediaType mediaType; 215 216 @SerializedName("media_url") 217 public List<String> mediaUrl = new ArrayList<String>(); 218 } 219 220 public enum ProblemType { 221 @SerializedName("REFUND") 222 REFUND, 223 @SerializedName("SERVICE_NOT_WORK") 224 SERVICE_NOT_WORK, 225 @SerializedName("OTHERS") 226 OTHERS 227 } 228 229 public enum UserTag { 230 @SerializedName("TRUSTED") 231 TRUSTED, 232 @SerializedName("HIGH_RISK") 233 HIGH_RISK 234 } 235 236 public static class ServiceOrderInfo { 237 @SerializedName("order_id") 238 public String orderId; 239 240 @SerializedName("out_order_no") 241 public String outOrderNo; 242 243 @SerializedName("state") 244 public ServiceOrderState state; 245 } 246 247 public static class AdditionalInfo { 248 @SerializedName("type") 249 public AdditionalType type; 250 251 @SerializedName("share_power_info") 252 public SharePowerInfo sharePowerInfo; 253 } 254 255 public enum ComplaintMediaType { 256 @SerializedName("USER_COMPLAINT_IMAGE") 257 USER_COMPLAINT_IMAGE, 258 @SerializedName("OPERATION_IMAGE") 259 OPERATION_IMAGE 260 } 261 262 public enum ServiceOrderState { 263 @SerializedName("DOING") 264 DOING, 265 @SerializedName("REVOKED") 266 REVOKED, 267 @SerializedName("WAITPAY") 268 WAITPAY, 269 @SerializedName("DONE") 270 DONE 271 } 272 273 public enum AdditionalType { 274 @SerializedName("SHARE_POWER_TYPE") 275 SHARE_POWER_TYPE 276 } 277 278 public static class SharePowerInfo { 279 @SerializedName("return_time") 280 public String returnTime; 281 282 @SerializedName("return_address_info") 283 public ReturnAddressInfo returnAddressInfo; 284 285 @SerializedName("is_returned_to_same_machine") 286 public Boolean isReturnedToSameMachine; 287 } 288 289 public static class ReturnAddressInfo { 290 @SerializedName("return_address") 291 public String returnAddress; 292 293 @SerializedName("longitude") 294 public String longitude; 295 296 @SerializedName("latitude") 297 public String latitude; 298 } 299 300} 301
需配合微信支付工具库 wxpay_utility 使用,请参考Go
1package main 2 3import ( 4 "demo/wxpay_utility" // 引用微信支付工具库,参考 https://pay.weixin.qq.com/doc/v3/merchant/4015119334 5 "encoding/json" 6 "fmt" 7 "net/http" 8 "net/url" 9) 10 11func main() { 12 // TODO: 请准备商户开发必要参数,参考:https://pay.weixin.qq.com/doc/v3/merchant/4013070756 13 config, err := wxpay_utility.CreateMchConfig( 14 "19xxxxxxxx", // 商户号,是由微信支付系统生成并分配给每个商户的唯一标识符,商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/merchant/4013070756 15 "1DDE55AD98Exxxxxxxxxx", // 商户API证书序列号,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013053053 16 "/path/to/apiclient_key.pem", // 商户API证书私钥文件路径,本地文件路径 17 "PUB_KEY_ID_xxxxxxxxxxxxx", // 微信支付公钥ID,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816 18 "/path/to/wxp_pub.pem", // 微信支付公钥文件路径,本地文件路径 19 ) 20 if err != nil { 21 fmt.Println(err) 22 return 23 } 24 25 request := &ListComplaintsV2Request{ 26 Limit: wxpay_utility.Int64(5), 27 Offset: wxpay_utility.Int64(10), 28 BeginDate: wxpay_utility.String("2019-01-01"), 29 EndDate: wxpay_utility.String("2019-01-01"), 30 ComplaintedMchid: wxpay_utility.String("1900012181"), 31 } 32 33 response, err := ListComplaintsV2(config, request) 34 if err != nil { 35 fmt.Printf("请求失败: %+v\n", err) 36 // TODO: 请求失败,根据状态码执行不同的处理 37 return 38 } 39 40 // TODO: 请求成功,继续业务逻辑 41 fmt.Printf("请求成功: %+v\n", response) 42} 43 44func ListComplaintsV2(config *wxpay_utility.MchConfig, request *ListComplaintsV2Request) (response *ListComplaintsV2Response, err error) { 45 const ( 46 host = "https://api.mch.weixin.qq.com" 47 method = "GET" 48 path = "/v3/merchant-service/complaints-v2" 49 ) 50 51 reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path)) 52 if err != nil { 53 return nil, err 54 } 55 query := reqUrl.Query() 56 if request.Limit != nil { 57 query.Add("limit", fmt.Sprintf("%v", *request.Limit)) 58 } 59 if request.Offset != nil { 60 query.Add("offset", fmt.Sprintf("%v", *request.Offset)) 61 } 62 if request.BeginDate != nil { 63 query.Add("begin_date", *request.BeginDate) 64 } 65 if request.EndDate != nil { 66 query.Add("end_date", *request.EndDate) 67 } 68 if request.ComplaintedMchid != nil { 69 query.Add("complainted_mchid", *request.ComplaintedMchid) 70 } 71 reqUrl.RawQuery = query.Encode() 72 httpRequest, err := http.NewRequest(method, reqUrl.String(), nil) 73 if err != nil { 74 return nil, err 75 } 76 httpRequest.Header.Set("Accept", "application/json") 77 httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId()) 78 authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), nil) 79 if err != nil { 80 return nil, err 81 } 82 httpRequest.Header.Set("Authorization", authorization) 83 84 client := &http.Client{} 85 httpResponse, err := client.Do(httpRequest) 86 if err != nil { 87 return nil, err 88 } 89 respBody, err := wxpay_utility.ExtractResponseBody(httpResponse) 90 if err != nil { 91 return nil, err 92 } 93 if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 { 94 // 2XX 成功,验证应答签名 95 err = wxpay_utility.ValidateResponse( 96 config.WechatPayPublicKeyId(), 97 config.WechatPayPublicKey(), 98 &httpResponse.Header, 99 respBody, 100 ) 101 if err != nil { 102 return nil, err 103 } 104 response := &ListComplaintsV2Response{} 105 if err := json.Unmarshal(respBody, response); err != nil { 106 return nil, err 107 } 108 109 return response, nil 110 } else { 111 return nil, wxpay_utility.NewApiException( 112 httpResponse.StatusCode, 113 httpResponse.Header, 114 respBody, 115 ) 116 } 117} 118 119type ListComplaintsV2Request struct { 120 Limit *int64 `json:"limit,omitempty"` 121 Offset *int64 `json:"offset,omitempty"` 122 BeginDate *string `json:"begin_date,omitempty"` 123 EndDate *string `json:"end_date,omitempty"` 124 ComplaintedMchid *string `json:"complainted_mchid,omitempty"` 125} 126 127func (o *ListComplaintsV2Request) MarshalJSON() ([]byte, error) { 128 type Alias ListComplaintsV2Request 129 a := &struct { 130 Limit *int64 `json:"limit,omitempty"` 131 Offset *int64 `json:"offset,omitempty"` 132 BeginDate *string `json:"begin_date,omitempty"` 133 EndDate *string `json:"end_date,omitempty"` 134 ComplaintedMchid *string `json:"complainted_mchid,omitempty"` 135 *Alias 136 }{ 137 // 序列化时移除非 Body 字段 138 Limit: nil, 139 Offset: nil, 140 BeginDate: nil, 141 EndDate: nil, 142 ComplaintedMchid: nil, 143 Alias: (*Alias)(o), 144 } 145 return json.Marshal(a) 146} 147 148type ListComplaintsV2Response struct { 149 Data []ComplaintInfo `json:"data,omitempty"` 150 Limit *int64 `json:"limit,omitempty"` 151 Offset *int64 `json:"offset,omitempty"` 152 TotalCount *int64 `json:"total_count,omitempty"` 153} 154 155type ComplaintInfo struct { 156 ComplaintId *string `json:"complaint_id,omitempty"` 157 ComplaintTime *string `json:"complaint_time,omitempty"` 158 ComplaintDetail *string `json:"complaint_detail,omitempty"` 159 ComplaintState *string `json:"complaint_state,omitempty"` 160 PayerPhone *string `json:"payer_phone,omitempty"` 161 ComplaintOrderInfo []ComplaintOrderInfo `json:"complaint_order_info,omitempty"` 162 ComplaintFullRefunded *bool `json:"complaint_full_refunded,omitempty"` 163 IncomingUserResponse *bool `json:"incoming_user_response,omitempty"` 164 UserComplaintTimes *int64 `json:"user_complaint_times,omitempty"` 165 ComplaintMediaList []ComplaintMedia `json:"complaint_media_list,omitempty"` 166 ProblemDescription *string `json:"problem_description,omitempty"` 167 ProblemType *ProblemType `json:"problem_type,omitempty"` 168 ApplyRefundAmount *int64 `json:"apply_refund_amount,omitempty"` 169 UserTagList []UserTag `json:"user_tag_list,omitempty"` 170 ServiceOrderInfo []ServiceOrderInfo `json:"service_order_info,omitempty"` 171 AdditionalInfo *AdditionalInfo `json:"additional_info,omitempty"` 172 InPlatformService *bool `json:"in_platform_service,omitempty"` 173 NeedImmediateService *bool `json:"need_immediate_service,omitempty"` 174} 175 176type ComplaintOrderInfo struct { 177 TransactionId *string `json:"transaction_id,omitempty"` 178 OutTradeNo *string `json:"out_trade_no,omitempty"` 179 Amount *int64 `json:"amount,omitempty"` 180} 181 182type ComplaintMedia struct { 183 MediaType *ComplaintMediaType `json:"media_type,omitempty"` 184 MediaUrl []string `json:"media_url,omitempty"` 185} 186 187type ProblemType string 188 189func (e ProblemType) Ptr() *ProblemType { 190 return &e 191} 192 193const ( 194 PROBLEMTYPE_REFUND ProblemType = "REFUND" 195 PROBLEMTYPE_SERVICE_NOT_WORK ProblemType = "SERVICE_NOT_WORK" 196 PROBLEMTYPE_OTHERS ProblemType = "OTHERS" 197) 198 199type UserTag string 200 201func (e UserTag) Ptr() *UserTag { 202 return &e 203} 204 205const ( 206 USERTAG_TRUSTED UserTag = "TRUSTED" 207 USERTAG_HIGH_RISK UserTag = "HIGH_RISK" 208) 209 210type ServiceOrderInfo struct { 211 OrderId *string `json:"order_id,omitempty"` 212 OutOrderNo *string `json:"out_order_no,omitempty"` 213 State *ServiceOrderState `json:"state,omitempty"` 214} 215 216type AdditionalInfo struct { 217 Type *AdditionalType `json:"type,omitempty"` 218 SharePowerInfo *SharePowerInfo `json:"share_power_info,omitempty"` 219} 220 221type ComplaintMediaType string 222 223func (e ComplaintMediaType) Ptr() *ComplaintMediaType { 224 return &e 225} 226 227const ( 228 COMPLAINTMEDIATYPE_USER_COMPLAINT_IMAGE ComplaintMediaType = "USER_COMPLAINT_IMAGE" 229 COMPLAINTMEDIATYPE_OPERATION_IMAGE ComplaintMediaType = "OPERATION_IMAGE" 230) 231 232type ServiceOrderState string 233 234func (e ServiceOrderState) Ptr() *ServiceOrderState { 235 return &e 236} 237 238const ( 239 SERVICEORDERSTATE_DOING ServiceOrderState = "DOING" 240 SERVICEORDERSTATE_REVOKED ServiceOrderState = "REVOKED" 241 SERVICEORDERSTATE_WAITPAY ServiceOrderState = "WAITPAY" 242 SERVICEORDERSTATE_DONE ServiceOrderState = "DONE" 243) 244 245type AdditionalType string 246 247func (e AdditionalType) Ptr() *AdditionalType { 248 return &e 249} 250 251const ( 252 ADDITIONALTYPE_SHARE_POWER_TYPE AdditionalType = "SHARE_POWER_TYPE" 253) 254 255type SharePowerInfo struct { 256 ReturnTime *string `json:"return_time,omitempty"` 257 ReturnAddressInfo *ReturnAddressInfo `json:"return_address_info,omitempty"` 258 IsReturnedToSameMachine *bool `json:"is_returned_to_same_machine,omitempty"` 259} 260 261type ReturnAddressInfo struct { 262 ReturnAddress *string `json:"return_address,omitempty"` 263 Longitude *string `json:"longitude,omitempty"` 264 Latitude *string `json:"latitude,omitempty"` 265} 266
应答参数
200 OK
data 选填 array[object]
【用户投诉信息详情】 用户投诉信息详情
属性 | |||||||||||||||||||||||||
complaint_id 必填 string(64) 【投诉单号】 投诉单对应的投诉单号 complaint_time 必填 string(32) 【投诉时间】 投诉时间 complaint_detail 必填 string(300) 【投诉详情】 投诉的具体描述 complaint_state 必填 string(30) 【投诉单状态】 标识当前投诉单所处的处理阶段,具体状态如下所示: payer_phone 选填 string(512) 【投诉人联系方式】 投诉人联系方式。该字段已做加密处理,具体解密方法详见如何使用API证书解密敏感字段 complaint_order_info 选填 array[object] 【投诉单关联订单信息】 投诉单关联订单信息
complaint_full_refunded 必填 boolean 【投诉单是否已全额退款】 投诉单下所有订单是否已全部全额退款 incoming_user_response 必填 boolean 【是否有待回复的用户留言】 投诉单是否有待回复的用户留言 user_complaint_times 必填 integer 【用户投诉次数】 用户投诉次数。用户首次发起投诉记为1次,用户每有一次继续投诉就加1 complaint_media_list 选填 array[object] 【投诉资料列表】 用户上传的投诉相关资料,包括图片凭证等
problem_description 必填 string(256) 【问题描述】 用户发起投诉前选择的faq标题(2021年7月15日之后的投诉单均包含此信息) problem_type 选填 string 【问题类型】 问题类型为申请退款的单据是需要最高优先处理的单据 可选取值
apply_refund_amount 选填 integer 【申请退款金额】 仅当问题类型为申请退款时, 有值, (单位:分) user_tag_list 选填 array[string] 【用户标签列表】 用户标签列表 可选取值
service_order_info 选填 array[object] 【投诉单关联服务单信息】
additional_info 选填 object 【补充信息】 用在特定行业或场景下返回的补充信息
in_platform_service 选填 boolean 【是否在平台协助中】 标识当前投诉单是否正处在平台协助流程中。注:在协助期间由微信支付客服为用户服务,期间商户向用户发送的留言用户不可见 need_immediate_service 选填 boolean 【是否需即时服务用户】 因用户诉求紧急度、用户界面差异等因素,部分投诉单建议商户更即时地响应用户诉求。如此处标识为“是”,建议商户提升服务时效,给用户带来更好的体验 |
limit 必填 integer
【分页大小】 设置该次请求返回的最大投诉条数,范围[1,50]
offset 必填 integer
【分页开始位置】 该次请求的分页开始位置,从0开始计数,例如offset=10,表示从第11条记录开始返回。
total_count 选填 integer
【投诉总条数】 投诉总条数,当offset=0时返回
应答示例
200 OK
1{ 2 "data" : [ 3 { 4 "complaint_id" : "200201820200101080076610000", 5 "complaint_time" : "2015-05-20T13:29:35.120+08:00", 6 "complaint_detail" : "反馈一个重复扣费的问题", 7 "complaint_state" : "PENDING", 8 "payer_phone" : "18500000000", 9 "complaint_order_info" : [ 10 { 11 "transaction_id" : "4200000404201909069117582536", 12 "out_trade_no" : "20190906154617947762231", 13 "amount" : 3 14 } 15 ], 16 "complaint_full_refunded" : true, 17 "incoming_user_response" : true, 18 "user_complaint_times" : 1, 19 "complaint_media_list" : [ 20 { 21 "media_type" : "USER_COMPLAINT_IMAGE", 22 "media_url" : [ 23 "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx" 24 ] 25 } 26 ], 27 "problem_description" : "不满意商家服务", 28 "problem_type" : "REFUND", 29 "apply_refund_amount" : 10, 30 "user_tag_list" : [ 31 "TRUSTED" 32 ], 33 "service_order_info" : [ 34 { 35 "order_id" : "15646546545165651651", 36 "out_order_no" : "1234323JKHDFE1243252", 37 "state" : "DOING" 38 } 39 ], 40 "additional_info" : { 41 "type" : "SHARE_POWER_TYPE", 42 "share_power_info" : { 43 "return_time" : "2015-05-20T13:29:35+08:00", 44 "return_address_info" : { 45 "return_address" : "广东省深圳市南山区海天二路南山区后海腾讯滨海大厦(海天二路西)", 46 "longitude" : "113.93535488533665", 47 "latitude" : "22.52305518747831" 48 }, 49 "is_returned_to_same_machine" : false 50 } 51 }, 52 "in_platform_service" : true, 53 "need_immediate_service" : true 54 } 55 ], 56 "limit" : 5, 57 "offset" : 10, 58 "total_count" : 1000 59} 60
错误码
公共错误码