Skip to content

退款订单查询

公共参数

参数类型是否必填最大长度描述示例
mch_noString32商户号2014072300007148
methodString128接口名称trade.pay.refund.query
charsetString10调用的接口版本,固定为:utf-8utf-8
sign_typeString10商户生成签名字符串所使用的签名算法类型,目前支持 RSARSA
signString344商户请求参数的签名串详见示例
timestampString19发送请求的时间,格式"yyyy-MM-dd HH:mm:ss"2014-07-24 03:07:50
versionString3调用的接口版本,固定为:1.01.0
notify_urlString256异步通知地址
return_urlString256同步跳转地址
biz_contentString业务参数

业务参数

参数类型是否必填最大长度描述示例
out_trade_noString二选一64商户订单号。由商家自定义,需保证在商户端不重复。20150320010101001
trade_noString二选一64平台商订单号20150320010101001
out_trade_refund_noString64商户退款订单号2015032001010100101

返回信息

json
返回结果示例:
{
    "code": 20000,
    "msg": "success",
    "out_trade_no": "1977641770112053316",   
    "refund_amount": "77.71", 
    "refund_status": "REFUND_SUCCESS",
    "trade_no": 836266688496631808,
    "succeed_at": 1760342272,
    "sign": "Qp2GW+xbOeqc4PtBrjfHZCwo0hvuKPrytuk5I/cjONARNdj05B9JaeLqjfReULsjGHjilkxxjnFXykUAxFwKFlPy+BrCNByo0Zxq38YR7tA5iAMITmYHcxxFPYRWoK0IH6i/wdzkyGP6lfQQFQg5VXuH96M4JjENLijBvSgtsB1qInaiAuNKtfe7HXtayvP//UbaLwqfFzvJWvhPXIF3ememrpzlTbplDuhPWyD6WWlplH93aMNAPJ7xPV2JtrM+M0mnMVU5fhLOJTJZaPi5As0+1n8MDb07EAf+y/Br8E9KZrdkhMSqYJ/2A3IeesJ/NUFAERArS6lEGekY+sF1Uw=="
}

返回字段说明

参数类型描述
codeInt20000
msgStringsuccess
out_trade_noString商户支付订单号
refund_amountString退款金额,单位元
refund_statusString退款状态(参照返回状态说明)
trade_noString鸿闻支付订单号
succeed_atNumber退款成功时间
signString签名字符串

返回状态说明

名称描述
REFUND_PROCESS退款中
REFUND_SUCCESS退款成功
REFUND_FAIL退款失败
REFUND_CANCEL退款取消
TRADE_REFUND已退款
REFUND_SUSPEND退款中断
REFUND_DEFAULT默认状态(无任何意义)