跳转至

退款查询接口

请求方式 body 编码 接口地址
POST application/json UTF-8 集测：https://mchapitest.shengpay.com/order/complaint/detail
生产：https://mchapi.shengpay.com/order/complaint/detail

请求参数

变量名 类型 必填 示例值 描述
mchId String(16) Y 93751497 商户号(如果有subMchId,一定要存在代理关系)
subMchId String(16) N 子商户号
complaintId String Y 投诉ID
nonceStr String(32) Y 随机字符串
signType String Y RSA 签名类型
Sign String Y 签名 (见签名介绍) 
1
2
3
4
5
6
7
8
{
    "mchId": "93751497",
    "subMchId": "93751497",
    "nonceStr": "LsLFojFEdOuvFCvEzsJOcNUk1JNX1Nb6",
    "complaintId": "1602834549305",
    "sign": "V/3/D9LRvX32uycrgEUwAUOWSPPAybg4XcoNJ+pQYnVFtRv8f+2zB5pQshk8xpvnoIXgc9xuVpCegz5E1PHNZ4Vdc739qVhX2AFlpHdTTJwmiwiaIwaLKSf8sGLz3qxrTuJHCMHh3GtjXc++CQfU3eZM5wBKRY+nWIe3c3J7X7IBdanMWzvXqOHRheIL0Cx4vUyzVjWSUwO9CMABw7PmVNHOGOmkD20Rk8xKc8fjQ7cG3+lYjhXefyAubJWS01uvwdWOeRWPuFy9Cn6DYql/GCYDjA8ppJbRsqOrOm2qmwkIqBnjc1QWUudQ2lFtqnstpJJWc5izlgMI8my+5mNzZQ==",
    "signType": "RSA"
}

响应参数

变量名 类型 必填 示例值 描述
returnCode String Y SUCCESS 返回码(SUCCESS/FAIL)
returnMsg String N 返回消息(当returnCode为FAIL时使用)
resultCode String Y SUCCESS 业务结果(SUCCESS/FAIL)
errorCode String N 错误代码(当resultCode为FAIL时使用)
errorCodeDes String N 错误描述(当resultCode为FAIL时使用)
mchId String N 93751497 商户号
outTradeNo String N 20210987612312 商户订单号
transactionId String N r20210987612312 产品订单号
sftInstOrderNo String N M20210987612312 提交机构订单号
officOrderNum String N 官方订单号
complaintId String N 投诉订单号
instMchId String N 10 银行商户号
tradeType String N 交易类型
shopName String N 交易所属门店名称
shopId String N 交易所属门店号
complaintDetail String（512） 投诉信息
tradeType String N 交易类型
amount int N 投诉金额
fullRefunded String N 投诉单是否已全额退款
complaintTime String N 投诉时间
payerPhone String N 投诉人联系方式
payerOpenid String N 投诉人OpenID
nickName String Y 昵称
complaintTimes String N 投诉次数
complaintState String N 投诉单状态,PENDING-待处理;PROCESSING-处理中;PROCESSED-已处理完成
userResponse String N 是否有待回复的用户留言
mediaList JSONArrayString N 投诉资料列表
problemType String N 问题类型 REFUND: 申请退款,SERVICE_NOT_WORK: 服务权益未生效, OTHERS: 其他类型
problemDescription String N 问题描述
applyRefundAmount String N 申请退款金额
userTagList JSONArrayString N 用户标签列表 TRUSTED: 此类用户满足极速退款条件, HIGH_RISK: 高风险投诉，请按照运营要求优先妥善处理
serviceOrderInfo JSONArrayString N 投诉单关联服务单信息
additionalInfo String N 补充信息
complaintOrderStep JSONArrayString N 当前投诉回复信息
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