查询退款

公众账号ID

appid

是

String(32)

wx8888888888888888

微信支付分配的公众账号ID（企业号corpid即为此appid）

商户号

mch_id

是

String(32)

1900000109

微信支付分配的商户号

随机字符串

nonce_str

是

String(32)

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

随机字符串，不长于32位。推荐随机数生成算法

签名

sign

是

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名，详见签名生成算法

签名类型

sign_type

否

String(32)

HMAC-SHA256

签名类型，目前支持HMAC-SHA256和MD5，默认为MD5

微信订单号

transaction_id

四选一

String(32)

1217752501201407033233368018

微信订单号查询的优先级是： refund_id > out_refund_no > transaction_id > out_trade_no

商户订单号

out_trade_no

String(32)

1217752501201407033233368018

商户系统内部订单号，要求32个字符内（最少6个字符），只能是数字、大小写字母_-|*且在同一个商户号下唯一。详见商户订单号

商户退款单号

out_refund_no

String(64)

1217752501201407033233368018

商户系统内部的退款单号，商户系统内部唯一，只能是数字、大小写字母_-|*@ ，同一退款单号多次请求只退一笔。

微信退款单号

refund_id

String(32)

1217752501201407033233368018

微信生成的退款单号，在申请退款接口有返回

偏移量

offset

否

int

15

偏移量，当部分退款次数超过10次时可使用，表示返回的查询结果从这个偏移量开始取记录

返回状态码

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

此字段是通信标识，表示接口层的请求结果，并非退款状态。

返回信息

return_msg

是

String(128)

OK

当return_code为FAIL时返回信息为错误原因 ，例如

签名失败

参数格式校验错误

业务结果

result_code

是

String(16)

SUCCESS

SUCCESS/FAIL

SUCCESS退款申请接收成功，退款结果以退款状态为准

FAIL

错误码

err_code

是

String(32)

SYSTEMERROR

错误码详见第6节

错误描述

err_code_des

是

String(128)

系统错误

结果信息描述

公众账号ID

appid

是

String(32)

wx8888888888888888

微信分配的公众账号ID（企业号corpid即为此appid）

商户号

mch_id

是

String(32)

1900000109

微信支付分配的商户号

随机字符串

nonce_str

是

String(32)

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

随机字符串，不长于32位

签名

sign

是

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名，详见签名算法

订单总退款次数

total_refund_count

否

int

35

订单总共已发生的部分退款次数，当请求参数传入offset后有返回

微信订单号

transaction_id

是

String(32)

1217752501201407033233368018

微信订单号

商户订单号

out_trade_no

是

String(32)

1217752501201407033233368018

商户系统内部订单号，要求32个字符内（最少6个字符），只能是数字、大小写字母_-|*且在同一个商户号下唯一。详见商户订单号

订单金额

total_fee

是

int

100

订单总金额，单位为分，只能为整数，详见支付金额

应结订单金额

settlement_total_fee

否

int

100

当订单使用了免充值型优惠券后返回该参数，应结订单金额=订单金额-免充值优惠券金额。

货币种类

fee_type

否

String(8)

CNY

订单金额货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型

现金支付金额

cash_fee

是

int

100

现金支付金额，单位为分，只能为整数，详见支付金额

退款笔数

refund_count

是

int

1

当前返回退款笔数

商户退款单号

out_refund_no_$n

是

String(64)

1217752501201407033233368018

商户系统内部的退款单号，商户系统内部唯一，只能是数字、大小写字母_-|*@ ，同一退款单号多次请求只退一笔。

微信退款单号

refund_id_$n

是

String(32)

1217752501201407033233368018

微信退款单号

退款渠道

refund_channel_$n

否

String(16)

ORIGINAL

ORIGINAL—原路退款

BALANCE—退回到余额

OTHER_BALANCE—原账户异常退到其他余额账户

OTHER_BANKCARD—原银行卡异常退到其他银行卡

申请退款金额

refund_fee_$n

是

int

100

退款总金额,单位为分,可以做部分退款

退款总金额

refund_fee

是

int

100

各退款单的退款金额累加

代金券退款总金额

coupon_refund_fee

是

int

100

各退款单的代金券退款金额累加

退款金额

settlement_refund_fee_$n

否

int

100

退款金额=申请退款金额-非充值代金券退款金额，退款金额<=申请退款金额

代金券类型

coupon_type_$n_$m

否

String(8)

CASH

CASH--充值代金券

NO_CASH---非充值优惠券

开通免充值券功能，并且订单使用了优惠券后有返回（取值：CASH、NO_CASH）。$n为下标,$m为下标,从0开始编号，举例：coupon_type_$0_$1

总代金券退款金额

coupon_refund_fee_$n

否

int

100

代金券退款金额<=退款金额，退款金额-代金券或立减优惠退款金额为现金，说明详见代金券或立减优惠

退款代金券使用数量

coupon_refund_count_$n

否

int

1

退款代金券使用数量 ,$n为下标,从0开始编号

退款代金券ID

coupon_refund_id_$n_$m

否

String(20)

10000 

退款代金券ID, $n为下标，$m为下标，从0开始编号

单个代金券退款金额

coupon_refund_fee_$n_$m

否

int

100

单个退款代金券支付金额, $n为下标，$m为下标，从0开始编号

退款状态

refund_status_$n

是

String(16)

SUCCESS

退款状态：

SUCCESS—退款成功

REFUNDCLOSE—退款关闭，指商户发起退款失败的情况。

PROCESSING—退款处理中

CHANGE—退款异常，退款到银行发现用户的卡作废或者冻结了，导致原路退款银行卡失败，可前往商户平台（pay.weixin.qq.com）-交易中心，手动处理此笔退款。$n为下标，从0开始编号。

退款资金来源

refund_account_$n

否

String(30)

REFUND_SOURCE_RECHARGE_FUNDS

REFUND_SOURCE_RECHARGE_FUNDS---可用余额退款/基本账户

REFUND_SOURCE_UNSETTLED_FUNDS---未结算资金退款

$n为下标，从0开始编号。

退款入账账户

refund_recv_accout_$n

是

String(64)

招商银行信用卡0403

取当前退款单的退款入账方

1）退回银行卡：{银行名称}{卡类型}{卡尾号}

2）退回支付用户零钱:支付用户零钱

3）退还商户:商户基本账户、商户结算银行账户

4）退回支付用户零钱通:支付用户零钱通

5）退回用户经营账户：用户经营账户

6）退回支付用户银行电子账户：支付用户银行电子账户

7）退回支付用户零花钱：支付用户零花钱

8）退回支付用户来华零钱包：支付用户来华零钱包

9）退回企业支付商户：企业支付商户

退款成功时间

refund_success_time_$n

否

String(20)

2016-07-25 15:26:26

退款成功时间，当退款状态为退款成功时有返回。$n为下标，从0开始编号。

用户退款金额

cash_refund_fee

是

int

90

退款给用户的金额，不包含所有优惠券金额

SYSTEMERROR

接口返回错误

系统超时

请尝试再次调用API。

REFUNDNOTEXIST

退款订单查询失败

订单号错误或订单状态不正确

请检查订单号是否有误以及订单状态是否正确，如：未支付、已支付未退款

INVALID_TRANSACTIONID

无效transaction_id

请求参数未按指引进行填写

请求参数错误，检查原交易号是否存在或发起支付交易接口返回失败

PARAM_ERROR

参数错误

请求参数未按指引进行填写

请求参数错误，请检查参数再调用退款申请

APPID_NOT_EXIST

APPID不存在

参数中缺少APPID

请检查APPID是否正确

MCHID_NOT_EXIST

MCHID不存在

参数中缺少MCHID

请检查MCHID是否正确

REQUIRE_POST_METHOD

请使用post方法

未使用post传递参数 

请检查请求参数是否通过post方法提交

SIGNERROR

签名错误

参数签名结果不正确

请检查签名参数和方法是否都符合签名算法要求

XML_FORMAT_ERROR

XML格式错误

XML格式错误

请检查XML参数格式是否正确

INVALID_REQUEST

请求参数符合参数格式，但不符合业务规则

此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理。

此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理。