跳转至

投诉通知接口

请求方式 body 编码
POST application/json UTF-8

通知确认：如果确认本次通知结果直接response返回SUCCESS，返回非SUCCESS，将会持续接收相同通知，累计10次，逐步增加每次通知间隔

通知参数

变量名 类型 必填 示例值 描述
outTradeNo String N 20210987612312 商户订单号
transactionId String N r20210987612312 产品订单号
sftInstOrderNo String N M20210987612312 提交机构订单号
officOrderNum String N 官方订单号
complaintId String N 投诉订单号
mchId String N 93751497 商户号
instMchId String N 10 银行商户号
tradeType String N 交易类型
complaintDetail String（512） 投诉信息
tradeType String N 交易类型
amount int N 投诉金额
fullRefunded String Y 投诉单是否已全额退款
complaintTime String N 投诉时间
payerPhone String N 投诉人联系方式
payerOpenid String N 投诉人OpenID
nickName String Y 昵称
complaintTimes String N 投诉次数
complaintState String N 投诉单状态,PENDING-待处理;PROCESSING-处理中;PROCESSED-已处理完成
userResponse String Y 是否有待回复的用户留言
mchShopName String N 交易所属门店名称
mchShopCode String N 交易所属门店号
mediaList JSONArrayString Y 投诉资料列表
problemType String N 问题类型 REFUND: 申请退款,SERVICE_NOT_WORK: 服务权益未生效, OTHERS: 其他类型
problemDescription String N 问题描述
applyRefundAmount String Y 申请退款金额
userTagList JSONArrayString Y 用户标签列表 TRUSTED: 此类用户满足极速退款条件, HIGH_RISK: 高风险投诉，请按照运营要求优先妥善处理
serviceOrderInfo JSONArrayString Y 投诉单关联服务单信息
additionalInfo String Y 补充信息
complaintOrderStep JSONArrayString Y 当前投诉回复信息
wxChannelNo String Y 微信服务商
wxChannelName String Y 微信服务商名称
payChannel String Y 投诉渠道 普通微信
expireTime String Y 过期时间--小程序
appealState String Y 申诉状态--小程序
nonceStr String N 随机字符串
signType String N rsa 签名类型
sign String N 签名 (见签名介绍)

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
   "returnCode" : "SUCCESS",
   "resultCode" : "SUCCESS",
   "errorCode" : null,
   "errorCodeDes" : null,
   "outTradeNo" : "2024042019021917657328184341x",
   "transactionId" : "M20240420988519184210911233",
   "sftInstOrderNo" : null,
   "officOrderNum" : null,
   "complaintId" : "200000020240422100168692210",
   "mchId" : "41021943",
   "instMchId" : "601178810",
   "tradeType" : null,
   "complaintDetail" : "我已经给过钱了 为什么又给一次 当时太急忙了没看",
   "amount" : 0,
   "fullRefunded" : "false",
   "complaintTime" : "2024-04-22 10:04:28",
   "payerPhone" : "13794770507",
   "payerOpenid" : "o7Kcet4iHvjiIgrIuGub5r-B5h34",
   "complaintTimes" : null,
   "complaintState" : "PENDING",
   "userResponse" : "false",
   "shopName" : null,
   "shopId" : null,
   "mediaList" : "[{\"media_type\":\"USER_COMPLAINT_IMAGE\",\"media_url\":[\"https://api.mch.weixin.qq.com/v3/merchant-service/images/ChsyMDAwMDAwMjAyNDA0MjIxMDAxNjg2OTIyMTAYACC3i5exBigBMAE4AQ%3D%3D\"]}]",
   "problemType" : "REFUND",
   "problemDescription" : "设备故障导致重复收费",
   "applyRefundAmount" : null,
   "userTagList" : "[]",
   "serviceOrderInfo" : "[]",
   "additionalInfo" : "[]",
   "complaintOrderStep" : "[{\"actionType\":\"CREATE_COMPLAINT\",\"amount\":600,\"complaintDetail\":\"我已经给过钱了 为什么又给一次 当时太急忙了没看\",\"complaintHandleState\":\"WAIT_MERCHANT_RESPONSE\",\"complaintId\":\"200000020240422100168692210\",\"complaintState\":\"PAYER_COMPLAINTED\",\"complaintTime\":\"2024-04-22 10:04:28\",\"complaintTimes\":1}]"
}
Back to top