跳转至

查询回退结果

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

接口描述

发起回退请求后，可调用此接口查询回退结果，建议回退受理5分钟之后发起查询，如果未查到回退结果，可以再间隔5分钟之后发起查询。

请求参数

变量名 类型 必填 示例值 描述
mchId String(10) Y 30057906 商户号
mchReturnNo String(64) Y 202008300806125346 商户回退单号
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍)

请求示例

1
2
3
4
5
6
7
{
    "mchId": "88021534",
    "mchReturnNo": "1627883697",
    "nonceStr": "nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy",
    "signType": "RSA",
    "sign": "VJwA2kXDnLiC8bH7Ywzc/fktd5zITLi9d5dobzaf3PCKy7hMecg1zqQz9X9GhqLMj5e2dOeDI2mrF06EJZdugcD+5BW2MA+MK32eMuwoRAh510HSusN2HaE4ser99rLJSvMPn5bEqNdDX83XixGePa4iyFiV0YdOfDu0T6VgDBFwbO0St73j0NxgPrIVM/tTmax1jwsAUl60BG4N+LKZxQYH0whsUOE9jgAjhcX8BD0GC3BMzNaEZyrn6noWvA6Ir95f/ZXww07rp8vPPzn99LtNzBFczx3k3H9o4e4K5BL+d+bzULMm9VvWrSObBri+wMy+VB978wGVftobFUkn/Q=="
}

响应参数

变量名 类型 必填 示例值 描述
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(10) N 商户号
mchSharingNo String(64) N 商户分账单号
returnNo String(64) N 盛付通回退单号
mchReturnNo String(64) N 商户回退单号
returnStatus String(10) N SUCCESS 回退方类型,回退状态 SUCCESS-成功 FAIL-失败 ING-处理中
returnReceiverType String(16) Y B B商户，C钱包会员
returnReceiverId String(64) Y 44541649 回退方类型是B时，是商户号
回退方类型是C时，是钱包会员unionId
returnAmount int N 回退金额,单位分
finishTime String(32) N 20200908182244 回退完成时间
failReason String(64) N 失败原因,仅在失败有值
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名

响应参数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
{
    "resultCode": "SUCCESS",
    "returnCode": "SUCCESS",
    "returnMsg": "OK",
    "mchId": "88021534",
    "mchSharingNo": "1627883616",
    "returnStatus": "SUCCESS",
    "finishTime": "20210802135458",
    "mchReturnNo": "1627883697",
    "returnNo": "R628953070625619968",
    "returnReceiverType": "B",
    "returnReceiverId": "88021534",
    "returnAmount": 10,
    "sign": "XyIoxGodrNZqsPE6xut9Yd0Pq5sk1VBkKAb7McrBgRtJr7R83u3n5ckTZByn4rxXUglViO3EYA8sYCWl54nNQf+5AVluJIZu5BmO6rZLxtgcCE2ismw3nqTX880RK/E+HtFHnpBqyf14ua5+MQ1gvt0r+klql7/+Osu3QF9LtGk=",
    "signType": "RSA",
    "nonceStr": "iuwYIztuezXtzoJmRfsDZKhsFTxOuznj"
}

错误码

错误码 描述 解决方案
SIGN_ERROR 签名错误 验证签名算法
PARAMS_ERROR 参数问题 请检查参数值是否符合
SYSTEM_ERROR 系统错误 系统异常，请调用回退查询接口确认业务结果
NO_AUTH 无此接口权限 请申请此接口权限
ORDER_NOT_EXIST 订单不存在 请确认回退单号是否存在
Back to top