CloudPay.queryRefund()

支持端：云函数 2.0.2

盘问退款

说明

提交退款申请后，，，，，通过挪用该接口盘问退款状态。。。。。退款有一定延时，，，，，用零钱支付的退款20分钟内到账，，，，，银行卡支付的退款3个事情日后重新盘问退款状态。。。。。 注重：若是单个支付订单部分退款次数凌驾20次请使用退款单号盘问* 分页盘问*

当一个订单部分退款凌驾10笔后，，，，，商户用微信订单号或商户订单号调退款盘问API盘问退款时，，，，，默认返回前10笔和total_refund_count(退款单总笔数)。。。。。商户需要盘问统一订单下凌驾10笔的退款单时，，，，，可传入订单号及offset来盘问，，，，，微信支付会返回offset及后面的10笔，，，，，以此类推。。。。。当商户传入的offset凌驾total_refund_count，，，，，则系统会返回报错PARAM_ERROR。。。。。

举例：

一笔订单下的退款单有36笔，，，，，当商户想盘问第25笔时，，，，，可传入订单号及offset=24，，，，，微信支付平台会返回第25笔到第35笔的退款单信息，，，，，或商户可直接传入退款单号盘问退款

参数说明

字段名变量名必填类型示例值形貌

子商户号sub_mch_id是String(32)1900000109微信支付分配的子商户号

随机字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串，，，，，不长于32位。。。。。推荐随机数天生算法

微信订单号transaction_id四选一String(28)1217752501201407033233368018微信订单号盘问的优先级是： refund_id > out_refund_no > transaction_id > out_trade_no

商户订单号out_trade_no四选一String(32)1217752501201407033233368018商户系统内部订单号，，，，，要求32个字符内，，，，，只能是数字、巨细写字母_-

商户退款单号out_refund_no四选一String(64)1217752501201407033233368018商户系统内部的退款单号，，，，，商户系统内部唯一，，，，，只能是数字、巨细写字母_-

微信退款单号refund_id四选一String(32)1217752501201407033233368018微信退款单号

偏移量offset否Int15偏移量，，，，，当部分退款次数凌驾10次时可使用，，，，，体现返回的盘问效果从这个偏移量最先取纪录

refund_id、out_refund_no、out_trade_no、transaction_id四个参数必填一个，，，，，若是同时保存优先级为： refund_id>out_refund_no>transaction_id>out_trade_no

返回值说明

字段名变量名必填类型示例值形貌

返回状态码returnCode是String(16)SUCCESSSUCCESS/FAIL

返回信息returnMsg否String(128)署名失败返回信息，，，，，如非空，，，，，为过失原因。。。。。如 署名失败、参数名堂校验过失

以下字段在returnCode为SUCCESS的时间有返回

字段名变量名必填类型示例值形貌

营业效果result_code是String(16)SUCCESSSUCCESS/FAIL

SUCCESS退款申请吸收乐成，，，，，效果通过退款盘问接口盘问

过失码err_code是String(32)SYSTEMERROR过失码详见第6节

过失形貌err_code_des是String(128)系统过失效果信息形貌

服务商的APPIDappid是String(32)wxd678efh567hg6787服务商商户的APPID

商户号mch_id是String(32)1230000109微信支付分配的商户号

小程序的APPIDsub_appid是String(32)wx8888888888888888微信分配的小程序ID

子商户号sub_mch_id是String(32)1900000109微信支付分配的子商户号

随机字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串，，，，，不长于32位

署名sign是String(32)C380BEC2BFD727A4B6845133519F3AD6署名，，，，，详见署名算法

微信订单号transaction_id是String(32)1217752501201407033233368018微信订单号

商户订单号out_trade_no是String(32)1217752501201407033233368018商户系统内部订单号，，，，，要求32个字符内，，，，，只能是数字、巨细写字母_-

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

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

钱币种类fee_type否String(8)CNY订单金额钱币类型，，，，，切合ISO 4217标准的三位字母代码，，，，，默认人民币：CNY，，，，，其他值列表详见钱币类型

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

退款笔数refund_count是Int1目今返回退款笔数

商户退款单号out_refund_no_$n是String(64)1217752501201407033233368018商户系统内部的退款单号，，，，，商户系统内部唯一，，，，，只能是数字、巨细写字母_-

微信退款单号refund_id_$n是String(32)1217752501201407033233368018微信退款单号

退款渠道refund_channel_$n否String(16)ORIGINALORIGINAL—原路退款

BALANCE—退回到余额

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

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

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

申请退款金额refund_fee_$n是Int100退款总金额,单位为分,可以做部分退款

退款金额settlement_refund_fee_$n否Int100退款金额=申请退款金额-非充值代金券退款金额，，，，，退款金额<=申请退款金额

代金券类型coupon_type_$n_$m否String(8)CASHCASH--充值代金券

NO_CASH---非充值代金券

订单使用代金券时有返回(取值：CASH、NO_CASH)。。。。。$n为下标,$m为下标,从0最先编号，，，，，举例：coupon_type_$0_$1

总代金券退款金额coupon_refund_fee_$n否Int100代金券退款金额<=退款金额，，，，，退款金额-代金券或立减优惠退款金额为现金，，，，，说明详见代金券或立减优惠

退款代金券使用数目coupon_refund_count_$n否Int1退款代金券使用数目 ,$n为下标,从0最先编号

退款代金券IDcoupon_refund_id_$n_$m否String(20)10000退款代金券ID, $n为下标，，，，，$m为下标，，，，，从0最先编号

单个代金券退款金额coupon_refund_fee_$n_$m否Int100单个退款代金券支付金额, $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_FUNDSREFUND_SOURCE_RECHARGE_FUNDS---可用余额退款/基本账户

REFUND_SOURCE_UNSETTLED_FUNDS---未结算资金退款

$n为下标，，，，，从0最先编号。。。。。

退款入账账户refund_recv_accout_$n是String(64)招商银行信用卡0403取目今退款单的退款入账方

1)退回银行卡：

{银行名称}{卡类型}{卡尾号}

2)退回支付用户零钱:

支付用户零钱

3)退还商户:

商户基本账户

商户结算银行账户

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

支付用户零钱通

退款乐成时间refund_success_time_$n否String(20)2016-07-25 15:26:26退款乐成时间，，，，，当退款状态为退款乐成时有返回。。。。。$n为下标，，，，，从0最先编号。。。。。

过失码

名称形貌原因解决方案

SYSTEMERROR接口返回过失系统超时请实验再次掉挪用API。。。。。

REFUNDNOTEXIST退款订单盘问失败订单号过失或订单状态不准确请检查订单号是否有误以及订单状态是否准确，，，，，如：未支付、已支付未退款

INVALID_TRANSACTIONID无效transaction_id请求参数未按指引举行填写请求参数过失，，，，，检查原生意号是否保存或提倡支付生意接口返回失败

PARAM_ERROR参数过失请求参数未按指引举行填写请求参数过失，，，，，请检查参数再挪用退款申请

APPID_NOT_EXISTAPPID不保存参数中缺少APPID请检查APPID是否准确

MCHID_NOT_EXISTMCHID不保存参数中缺少MCHID请检查MCHID是否准确

REQUIRE_POST_METHOD请使用post要领未使用post转达参数请检查请求参数是否通过post要领提交

SIGNERROR署名过失参数署名效果不准确请检查署名参数和要领是否都切合署名算法要求

XML_FORMAT_ERRORXML名堂过失XML名堂过失请检查XML参数名堂是否准确