跳转至

退款查询接口

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

请求参数

变量名 类型 必填 示例值 描述
mchId String(32) Y 93751497 商户号
outRefundNo String(64) Y 1602834549305 商户退款订单号和盛付通退款订单号至少一个不为空
returnAttach Boolean N false 是否返回退款备注，默认 false,当isReturnAttach=true时，返回退款备注
nonceStr String(32) Y 随机字符串
signType String Y RSA 签名类型
Sign String Y 签名 (见签名介绍) 
1
2
3
4
5
6
7
{
    "mchId": "93751497",
    "nonceStr": "LsLFojFEdOuvFCvEzsJOcNUk1JNX1Nb6",
    "outRefundNo": "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 Y 93751497 商户号
outTradeNo String Y 商户订单号
transactionId String Y 盛付通产品订单号
outRefundNo String Y 1602834549305 商户退款订单号
refundId String Y 盛付通退款订单号
refundFee int Y 2 退款金额 (分)
totalFee int Y 2 订单总金额 (分)
refundStatus String Y REFUND_SUCCESS 退款订单状态(见订单状态说明)
refundTime String Y 退款时间
mchMemberInfo String(256) N {"deviceId":s001","deviceName":"清河一店"} 商户终端信息(JSON字符串)
deviceId String(32) N s001 终端号
deviceName String(256) N 1号终端 终端名称
mchShopCode String(256) N BH02 门店号-商户系统注册门店的信息
mchShopName String(256) N 清河一店 门店名称-商户系统注册门店的信息
deviceTusn String(64) N SN0203420394029 设备序列号
attach String（512） N 附加信息
refundAccount String（512） N 退结算资金来源
nonceStr String Y 随机字符串
signType String Y RSA 签名类型
sign String Y 签名 (见签名介绍)

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
    "refundFee": 2,
    "mchId": "93751497",
    "outRefundNo": "1602834549305",
    "refundTime": "20201016155200",
    "resultCode": "SUCCESS",
    "sign": "L2derQ32UokxyTS3k6q/515ctXmZd2sEKYdkHC9/q/lzAxdTJgeBb3piQASrnpEbcSKIjD1yJbKzzsjKKehDDGo/BRSQsBDMpJfyE2cBCbDicH2c84kDx4CUTG3yNFhGojKoYqtKncf+EAx8UBQ6u6GCXvBHaaeRp3Svr9aWfM4=",
    "refundStatus": "REFUND_SUCCESS",
    "transactionId": "M20201015348067758698831872",
    "nonceStr": "bUHDySQtXMjfQmvGxDkjLXEqBqilxegN",
    "returnCode": "SUCCESS",
    "totalFee": 2,
    "outTradeNo": "8a8zg8sbw28hifn3hd5o",
    "signType": "RSA",
    "refundId": "MR20201016348520544091688960"
}
Back to top