订单退款查询接口
此接口用于查询订单退款的处理状态、退款金额等信息。
请求信息
请求URL |
/api/pay/refundquery |
请求方式 |
POST |
请求参数
参数名 |
类型 |
必填 |
示例值 |
说明 |
pid |
Int |
是 |
1001 |
商户ID |
refund_no |
String |
特殊 |
20160806151343349 |
平台退款单号,与商户退款单号必传其一 |
out_refund_no |
String |
特殊 |
20160806151343351 |
商户退款单号,与平台退款单号必传其一 |
timestamp |
String |
是 |
1721206072 |
当前时间戳,10位整数,单位秒 |
sign |
String |
是 |
|
签名字符串,详见签名规则 |
sign_type |
String |
是 |
RSA |
签名类型,默认为RSA |
返回参数
参数名 |
类型 |
示例值 |
说明 |
code |
Int |
0 |
返回状态码,0为成功,其它值为失败 |
msg |
String |
|
错误信息,失败时返回提示 |
refund_no |
String |
20160806151343349 |
平台退款单号 |
out_refund_no |
String |
20160806151343351 |
商户退款单号 |
trade_no |
String |
20160806151343349 |
平台订单号 |
out_trade_no |
String |
20160806151343351 |
商户订单号 |
money |
String |
1.00 |
退款金额 |
reducemoney |
String |
1.00 |
扣减商户余额 |
status |
Int |
1 |
退款状态,0:失败,1:成功 |
addtime |
String |
2024-07-01 16:47:32 |
退款时间 |
timestamp |
String |
1721206072 |
当前时间戳,10位整数,单位秒 |
sign |
String |
|
签名字符串,详见签名规则 |
sign_type |
String |
RSA |
签名类型,默认为RSA |
返回示例
成功示例:
{
"code": 0,
"msg": "查询成功",
"refund_no": "20160806151343349",
"out_refund_no": "20160806151343391",
"trade_no": "20160806151343349",
"out_trade_no": "20160806151343351",
"money": "1.00",
"reducemoney": "1.00",
"status": 1,
"addtime": "2024-07-01 16:47:32",
"timestamp": "1721206072",
"sign": "xxxxx",
"sign_type": "RSA"
}
失败示例:
{
"code": -1,
"msg": "退款单号不存在"
}
其他说明
注意事项
- 建议在发起退款后,调用此接口确认退款状态。
- 退款成功后,系统会通过异步通知接口将退款结果通知给商户。
- 退款状态为成功时,表示资金已原路退回给付款方。
- 部分支付通道的退款可能会有一定延迟,请以最终退款状态为准。