admin
退款查询应用场景：
提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用余额支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。
接口地址：
https://qpay.qq.com/cgi-bin/pay/qpay_refund_query.cgi
是否需要证书：
否
接口规则
· 为保证交易安全性，采用HTTPS传输
· 采用POST方法提交
· 统一采用UTF-8字符编码
更多详情见接口规则
请求参数：
变量名
字段名
字段类型
必填
描述
示例
appid
应用ID
String(32)
否
腾讯开放平台或QQ互联平台审核通过的应用APPID
1007033799
mch_id
商户号
String(32)
是
QQ钱包分配的商户号
1900000109
sub_mch_id
子商户号
String(32)
是
子商户号或商户识别码
1900000109或9000000101
nonce_str
随机字符串
String(32)
是
随机字符串，不长于32位
3e5a036cb4bc3a677a38ad9d69eb3feb
sign
商户签名
String(128)
是
商户签名，详见商户签名算法规则
C380BEC2BFD727A4B6845133519F3AD6
refund_id
QQ钱包退款单号
String(32)
4选1
如果传入，则查询refund_id的退款详情，同时忽略out_refund_no参数
1121218133801201611098791376
out_refund_no
商户退款单号
String(32)
4选1
在refund_id没有传入时，如果传入out_refund_no，则查询out_refund_no的退款详情
2015080612
transaction_id
QQ钱包订单号
String(32)
4选1
请求30天或更久之前支付的订单时，此参数不能为空。在refund_id，out_refund_no没有传入时，如果传入transaction_id，则查询transaction_id相关的全部退款详情。transaction_id存在时，则忽略out_trade_no
1353933301461607211903715555
out_trade_no
商户订单号
String(32)
4选1
在上面3项都没有传入时，则查询transaction_id相关的全部退款详情。以上4项必须传入一个。
20150806125346
示例如下：
返回结果：
变量名
字段名
类型
必填
描述
示例
return_code
返回状态码
String(16)
是
SUCCESS/FAIL
SUCCESS
return_msg
返回信息
String(128)
否
返回信息，如非空，为错误原因
签名失败
retcode
手Q CGI原始错误码
String(16)
是
原始错误码
10025
retmsg
手Q CGI原始错误信息
String(128)
否
原始错误信息
系统繁忙
下列字段，在return_code为成功时有返回：
变量名
字段名
类型
必填
描述
示例
appid
应用ID
String(32)
否
腾讯开放平台或QQ互联平台审核通过的应用APPID
1007033799
mch_id
商户号
String(32)
是
QQ钱包分配的商户号
1900000109
sign
商户签名
String(128)
是
商户签名，详见商户签名算法规则
5K8264ILTKCH16CQ2502SI8ZNMTM67VS
result_code
业务结果
String(32)
是
SUCCESS/FAIL
SUCCESS
err_code
错误代码
String(32)
否
详情见错误代码
SYSTEMERROR
err_code_des
错误代码描述
String(128)
否
错误返回的信息描述
系统繁忙
nonce_str
随机字符串
String(32)
是
随机字符串，不长于32位。
3e5a036cb4bc3a677a38ad9d69eb3feb
下列字段，在result_code为成功时有返回：
变量名
字段名
类型
必填
描述
示例
transaction_id
QQ钱包订单号
String(32)
是
QQ钱包订单号
128355470147160281308949397
out_trade_no
商户订单号
String(32)
是
商户系统内部的订单号,32个字符内、可包含字母。其它说明见商户订单号
20150806125346
total_fee
订单金额
Int
是
商户订单总金额，单位为分，只能为整数，详见交易金额
888
cash_fee
用户支付金额
Int
是
用户本次交易中，实际支付的金额
666
fee_type
货币类型定义
String(16)
是
默认人民币：CNY
CNY
out_refund_no_$n
商户退款单号
String(32)
是
商户系统内部的退款单号，商户系统内部唯一，同一退款单号多次请求只退一笔
2015080612
refund_id_$n
QQ钱包退款单号
String(32)
是
QQ钱包退款单号，在成功受理商户的退款申请后，QQ钱包会为本次退款申请生成该 QQ钱包退款单号
1121218133801201611098791376
refund_channel_$n
退款方式
String(16)
是
ORIGINAL 原路退回
BALANCE 退款到余额
ORIGINAL
refund_fee_$n
退款申请金额
Int
是
本次退款申请的退回金额。单位：分 币种：人民币
666
coupon_refund_fee_$n
退款申请金额中，优惠或者立减的金额
Int
否
退款申请金额中，优惠或者立减的金额。
n 从0开始。
666
cash_refund_fee_$n
退款申请中的现金金额
Int
否
退款申请中的现金金额。
n 从0开始。
666
refund_status_$n
退款状态定义
String(16)
是
SUCCESS—退款成功
FAIL—退款失败
PROCESSING—退款发起成功，正在处理中
CHANGE—转入代发，退款到银行发现用户的卡作废或者冻结了，导致原路退款银行卡失败，可前往商户平台（qpay.qq.com）-交易管理，手动处理此笔退款。$n为下标，从0开始编号。
SUCCESS
refund_recv_accout_$n
退款入账账户
String(64)
是
取当前退款单的退款入账方
1）退回银行卡：
{银行名称}{卡类型}{卡尾号}
2）退回支付用户余额:
支付用户余额
招商银行信用卡0403
示例如下：
错误码：
错误码
描述
原因
解决办法
SYSTEMERROR
系统错误
系统错误
请用相同参数再次调用API
REFUNDNOTEXIST
退款订单查询失败
订单号错误或订单状态不正确
请检查订单号是否有误以及订单状态是否正确，如：未支付、已支付未退款
INVALID_TRANSACTIONID
无效transaction_id
请求参数未按指引进行填写
请求参数错误，检查原交易号是否存在或发起支付交易接口返回失败
PARAM_ERROR
参数错误
请求参数未按指引进行填写
请求参数错误，请重新检查再调用退款申请
APPID_NOT_EXIST
APPID不存在
参数中缺少APPID
请检查APPID是否正确
MCHID_NOT_EXIST
MCHID不存在
参数中缺少MCHID
请检查MCHID是否正确
APPID_MCHID_NOT_MATCH
appid和mch_id不匹配
appid和mch_id不匹配
请确认appid和mch_id是否匹配
REQUIRE_POST_METHOD
请使用post方法
未使用post传递参数
请检查请求参数是否通过post方法提交
SIGNERROR
签名错误
参数签名结果不正确
请检查签名参数和方法是否都符合签名算法要求
XML_FORMAT_ERROR
XML格式错误
XML格式错误
请检查XML参数格式是否正确
INVALID_CERTIFICATE
证书错误
客户端证书无效或未使用证书
检查是否客户端是否使用正确有效证书来请求，下载证书参见商户证书