查询投诉单列表
更新时间: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 使用,请参考 iwiki-document:inline_state
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 , 37 "PUB_KEY_ID_xxxxxxxxxxxxx", // 微信支付公钥ID,如何获取请参考 https://pay.weixin.qq.com/doc/v3/merchant/4013038816 38 "/path/to/wxp_pub.pem" // 微信支付公钥文件路径,本地文件路径 39 ); 40 41 ListComplaintsV2Request request = new ListComplaintsV2Request(); 42 request.limit = 5L; 43 request.offset = 10L; 44 request.beginDate = "2019-01-01"; 45 request.endDate = "2019-01-01"; 46 request.complaintedMchid = "1900012181"; 47 try { 48 ListComplaintsV2Response response = client.run(request); 49 // TODO: 请求成功,继续业务逻辑 50 System.out.println(response); 51 } catch (WXPayUtility.ApiException e) { 52 // TODO: 请求失败,根据状态码执行不同的逻辑 53 e.printStackTrace(); 54 } 55 } 56 57 public ListComplaintsV2Response run(ListComplaintsV2Request request) { 58 String uri = PATH; 59 Map<String, Object> args = new HashMap<>(); 60 args.put("limit", request.limit); 61 args.put("offset", request.offset); 62 args.put("begin_date", request.beginDate); 63 args.put("end_date", request.endDate); 64 args.put("complainted_mchid", request.complaintedMchid); 65 uri = uri + "?" + WXPayUtility.urlEncode(args); 66 67 Request.Builder reqBuilder = new Request.Builder().url(HOST + uri); 68 reqBuilder.addHeader("Accept", "application/json"); 69 reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId); 70 reqBuilder.addHeader("Authorization", WXPayUtility.buildAuthorization(mchid, certificateSerialNo, privateKey, METHOD, uri, null)); 71 reqBuilder.method(METHOD, null); 72 Request httpRequest = reqBuilder.build(); 73 74 // 发送HTTP请求 75 OkHttpClient client = new OkHttpClient.Builder().build(); 76 try (Response httpResponse = client.newCall(httpRequest).execute()) { 77 String respBody = WXPayUtility.extractBody(httpResponse); 78 if (httpResponse.code() >= 200 && httpResponse.code() < 300) { 79 // 2XX 成功,验证应答签名 80 WXPayUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey, 81 httpResponse.headers(), respBody); 82 83 // 从HTTP应答报文构建返回数据 84 return WXPayUtility.fromJson(respBody, ListComplaintsV2Response.class); 85 } else { 86 throw new WXPayUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers()); 87 } 88 } catch (IOException e) { 89 throw new UncheckedIOException("Sending request to " + uri + " failed.", e); 90 } 91 } 92 93 private final String mchid; 94 private final String certificateSerialNo; 95 private final PrivateKey privateKey; 96 private final String wechatPayPublicKeyId; 97 private final PublicKey wechatPayPublicKey; 98 99 public ListComplaintsV2(String mchid, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) { 100 this.mchid = mchid; 101 this.certificateSerialNo = certificateSerialNo; 102 this.privateKey = WXPayUtility.loadPrivateKeyFromPath(privateKeyFilePath); 103 this.wechatPayPublicKeyId = wechatPayPublicKeyId; 104 this.wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath); 105 } 106 107 public static class ListComplaintsV2Request { 108 @SerializedName("limit") 109 @Expose(serialize = false) 110 public Long limit; 111 112 @SerializedName("offset") 113 @Expose(serialize = false) 114 public Long offset; 115 116 @SerializedName("begin_date") 117 @Expose(serialize = false) 118 public String beginDate; 119 120 @SerializedName("end_date") 121 @Expose(serialize = false) 122 public String endDate; 123 124 @SerializedName("complainted_mchid") 125 @Expose(serialize = false) 126 public String complaintedMchid; 127 } 128 129 public static class ListComplaintsV2Response { 130 @SerializedName("data") 131 public List<ComplaintInfo> data; 132 133 @SerializedName("limit") 134 public Long limit; 135 136 @SerializedName("offset") 137 public Long offset; 138 139 @SerializedName("total_count") 140 public Long totalCount; 141 } 142 143 public static class ComplaintInfo { 144 @SerializedName("complaint_id") 145 public String complaintId; 146 147 @SerializedName("complaint_time") 148 public String complaintTime; 149 150 @SerializedName("complaint_detail") 151 public String complaintDetail; 152 153 @SerializedName("complaint_state") 154 public String complaintState; 155 156 @SerializedName("payer_phone") 157 public String payerPhone; 158 159 @SerializedName("complaint_order_info") 160 public List<ComplaintOrderInfo> complaintOrderInfo; 161 162 @SerializedName("complaint_full_refunded") 163 public Boolean complaintFullRefunded; 164 165 @SerializedName("incoming_user_response") 166 public Boolean incomingUserResponse; 167 168 @SerializedName("user_complaint_times") 169 public Long userComplaintTimes; 170 171 @SerializedName("complaint_media_list") 172 public List<ComplaintMedia> complaintMediaList; 173 174 @SerializedName("problem_description") 175 public String problemDescription; 176 177 @SerializedName("problem_type") 178 public ProblemType problemType; 179 180 @SerializedName("apply_refund_amount") 181 public Long applyRefundAmount; 182 183 @SerializedName("user_tag_list") 184 public List<UserTag> userTagList; 185 186 @SerializedName("service_order_info") 187 public List<ServiceOrderInfo> serviceOrderInfo; 188 189 @SerializedName("additional_info") 190 public AdditionalInfo additionalInfo; 191 192 @SerializedName("in_platform_service") 193 public Boolean inPlatformService; 194 195 @SerializedName("need_immediate_service") 196 public Boolean needImmediateService; 197 } 198 199 public static class ComplaintOrderInfo { 200 @SerializedName("transaction_id") 201 public String transactionId; 202 203 @SerializedName("out_trade_no") 204 public String outTradeNo; 205 206 @SerializedName("amount") 207 public Long amount; 208 } 209 210 public static class ComplaintMedia { 211 @SerializedName("media_type") 212 public ComplaintMediaType mediaType; 213 214 @SerializedName("media_url") 215 public List<String> mediaUrl = new ArrayList<String>(); 216 } 217 218 public enum ProblemType { 219 @SerializedName("REFUND") 220 REFUND, 221 @SerializedName("SERVICE_NOT_WORK") 222 SERVICE_NOT_WORK, 223 @SerializedName("OTHERS") 224 OTHERS 225 } 226 227 public enum UserTag { 228 @SerializedName("TRUSTED") 229 TRUSTED, 230 @SerializedName("HIGH_RISK") 231 HIGH_RISK 232 } 233 234 public static class ServiceOrderInfo { 235 @SerializedName("order_id") 236 public String orderId; 237 238 @SerializedName("out_order_no") 239 public String outOrderNo; 240 241 @SerializedName("state") 242 public ServiceOrderState state; 243 } 244 245 public static class AdditionalInfo { 246 @SerializedName("type") 247 public AdditionalType type; 248 249 @SerializedName("share_power_info") 250 public SharePowerInfo sharePowerInfo; 251 } 252 253 public enum ComplaintMediaType { 254 @SerializedName("USER_COMPLAINT_IMAGE") 255 USER_COMPLAINT_IMAGE, 256 @SerializedName("OPERATION_IMAGE") 257 OPERATION_IMAGE 258 } 259 260 public enum ServiceOrderState { 261 @SerializedName("DOING") 262 DOING, 263 @SerializedName("REVOKED") 264 REVOKED, 265 @SerializedName("WAITPAY") 266 WAITPAY, 267 @SerializedName("DONE") 268 DONE 269 } 270 271 public enum AdditionalType { 272 @SerializedName("SHARE_POWER_TYPE") 273 SHARE_POWER_TYPE 274 } 275 276 public static class SharePowerInfo { 277 @SerializedName("return_time") 278 public String returnTime; 279 280 @SerializedName("return_address_info") 281 public ReturnAddressInfo returnAddressInfo; 282 283 @SerializedName("is_returned_to_same_machine") 284 public Boolean isReturnedToSameMachine; 285 } 286 287 public static class ReturnAddressInfo { 288 @SerializedName("return_address") 289 public String returnAddress; 290 291 @SerializedName("longitude") 292 public String longitude; 293 294 @SerializedName("latitude") 295 public String latitude; 296 } 297 298} 299
需配合微信支付工具库 wxpay_utility 使用,请参考 iwiki-document:inline_state
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 query.Add("limit", fmt.Sprintf("%v", *request.Limit)) 57 query.Add("offset", fmt.Sprintf("%v", *request.Offset)) 58 query.Add("begin_date", *request.BeginDate) 59 query.Add("end_date", *request.EndDate) 60 query.Add("complainted_mchid", *request.ComplaintedMchid) 61 reqUrl.RawQuery = query.Encode() 62 httpRequest, err := http.NewRequest(method, reqUrl.String(), nil) 63 if err != nil { 64 return nil, err 65 } 66 httpRequest.Header.Set("Accept", "application/json") 67 httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId()) 68 authorization, err := wxpay_utility.BuildAuthorization(config.MchId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), nil) 69 if err != nil { 70 return nil, err 71 } 72 httpRequest.Header.Set("Authorization", authorization) 73 74 client := &http.Client{} 75 httpResponse, err := client.Do(httpRequest) 76 if err != nil { 77 return nil, err 78 } 79 respBody, err := wxpay_utility.ExtractResponseBody(httpResponse) 80 if err != nil { 81 return nil, err 82 } 83 if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 { 84 // 2XX 成功,验证应答签名 85 err = wxpay_utility.ValidateResponse( 86 config.WechatPayPublicKeyId(), 87 config.WechatPayPublicKey(), 88 &httpResponse.Header, 89 respBody, 90 ) 91 if err != nil { 92 return nil, err 93 } 94 response := &ListComplaintsV2Response{} 95 if err := json.Unmarshal(respBody, response); err != nil { 96 return nil, err 97 } 98 99 return response, nil 100 } else { 101 return nil, wxpay_utility.NewApiException( 102 httpResponse.StatusCode, 103 httpResponse.Header, 104 respBody, 105 ) 106 } 107} 108 109type ListComplaintsV2Request struct { 110 Limit *int64 `json:"limit,omitempty"` 111 Offset *int64 `json:"offset,omitempty"` 112 BeginDate *string `json:"begin_date,omitempty"` 113 EndDate *string `json:"end_date,omitempty"` 114 ComplaintedMchid *string `json:"complainted_mchid,omitempty"` 115} 116 117func (o *ListComplaintsV2Request) MarshalJSON() ([]byte, error) { 118 type Alias ListComplaintsV2Request 119 a := &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 *Alias 126 }{ 127 // 序列化时移除非 Body 字段 128 Limit: nil, 129 Offset: nil, 130 BeginDate: nil, 131 EndDate: nil, 132 ComplaintedMchid: nil, 133 Alias: (*Alias)(o), 134 } 135 return json.Marshal(a) 136} 137 138type ListComplaintsV2Response struct { 139 Data []ComplaintInfo `json:"data,omitempty"` 140 Limit *int64 `json:"limit,omitempty"` 141 Offset *int64 `json:"offset,omitempty"` 142 TotalCount *int64 `json:"total_count,omitempty"` 143} 144 145type ComplaintInfo struct { 146 ComplaintId *string `json:"complaint_id,omitempty"` 147 ComplaintTime *string `json:"complaint_time,omitempty"` 148 ComplaintDetail *string `json:"complaint_detail,omitempty"` 149 ComplaintState *string `json:"complaint_state,omitempty"` 150 PayerPhone *string `json:"payer_phone,omitempty"` 151 ComplaintOrderInfo []ComplaintOrderInfo `json:"complaint_order_info,omitempty"` 152 ComplaintFullRefunded *bool `json:"complaint_full_refunded,omitempty"` 153 IncomingUserResponse *bool `json:"incoming_user_response,omitempty"` 154 UserComplaintTimes *int64 `json:"user_complaint_times,omitempty"` 155 ComplaintMediaList []ComplaintMedia `json:"complaint_media_list,omitempty"` 156 ProblemDescription *string `json:"problem_description,omitempty"` 157 ProblemType *ProblemType `json:"problem_type,omitempty"` 158 ApplyRefundAmount *int64 `json:"apply_refund_amount,omitempty"` 159 UserTagList []UserTag `json:"user_tag_list,omitempty"` 160 ServiceOrderInfo []ServiceOrderInfo `json:"service_order_info,omitempty"` 161 AdditionalInfo *AdditionalInfo `json:"additional_info,omitempty"` 162 InPlatformService *bool `json:"in_platform_service,omitempty"` 163 NeedImmediateService *bool `json:"need_immediate_service,omitempty"` 164} 165 166type ComplaintOrderInfo struct { 167 TransactionId *string `json:"transaction_id,omitempty"` 168 OutTradeNo *string `json:"out_trade_no,omitempty"` 169 Amount *int64 `json:"amount,omitempty"` 170} 171 172type ComplaintMedia struct { 173 MediaType *ComplaintMediaType `json:"media_type,omitempty"` 174 MediaUrl []string `json:"media_url,omitempty"` 175} 176 177type ProblemType string 178 179func (e ProblemType) Ptr() *ProblemType { 180 return &e 181} 182 183const ( 184 PROBLEMTYPE_REFUND ProblemType = "REFUND" 185 PROBLEMTYPE_SERVICE_NOT_WORK ProblemType = "SERVICE_NOT_WORK" 186 PROBLEMTYPE_OTHERS ProblemType = "OTHERS" 187) 188 189type UserTag string 190 191func (e UserTag) Ptr() *UserTag { 192 return &e 193} 194 195const ( 196 USERTAG_TRUSTED UserTag = "TRUSTED" 197 USERTAG_HIGH_RISK UserTag = "HIGH_RISK" 198) 199 200type ServiceOrderInfo struct { 201 OrderId *string `json:"order_id,omitempty"` 202 OutOrderNo *string `json:"out_order_no,omitempty"` 203 State *ServiceOrderState `json:"state,omitempty"` 204} 205 206type AdditionalInfo struct { 207 Type *AdditionalType `json:"type,omitempty"` 208 SharePowerInfo *SharePowerInfo `json:"share_power_info,omitempty"` 209} 210 211type ComplaintMediaType string 212 213func (e ComplaintMediaType) Ptr() *ComplaintMediaType { 214 return &e 215} 216 217const ( 218 COMPLAINTMEDIATYPE_USER_COMPLAINT_IMAGE ComplaintMediaType = "USER_COMPLAINT_IMAGE" 219 COMPLAINTMEDIATYPE_OPERATION_IMAGE ComplaintMediaType = "OPERATION_IMAGE" 220) 221 222type ServiceOrderState string 223 224func (e ServiceOrderState) Ptr() *ServiceOrderState { 225 return &e 226} 227 228const ( 229 SERVICEORDERSTATE_DOING ServiceOrderState = "DOING" 230 SERVICEORDERSTATE_REVOKED ServiceOrderState = "REVOKED" 231 SERVICEORDERSTATE_WAITPAY ServiceOrderState = "WAITPAY" 232 SERVICEORDERSTATE_DONE ServiceOrderState = "DONE" 233) 234 235type AdditionalType string 236 237func (e AdditionalType) Ptr() *AdditionalType { 238 return &e 239} 240 241const ( 242 ADDITIONALTYPE_SHARE_POWER_TYPE AdditionalType = "SHARE_POWER_TYPE" 243) 244 245type SharePowerInfo struct { 246 ReturnTime *string `json:"return_time,omitempty"` 247 ReturnAddressInfo *ReturnAddressInfo `json:"return_address_info,omitempty"` 248 IsReturnedToSameMachine *bool `json:"is_returned_to_same_machine,omitempty"` 249} 250 251type ReturnAddressInfo struct { 252 ReturnAddress *string `json:"return_address,omitempty"` 253 Longitude *string `json:"longitude,omitempty"` 254 Latitude *string `json:"latitude,omitempty"` 255} 256
应答参数
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
错误码
公共错误码