CloudPay.refund()

支持端：云函數(shù) 2.0.2

申請(qǐng)退款

說(shuō)明

當(dāng)交易發(fā)生之后一段時(shí)間內(nèi)，由于買(mǎi)家或者賣(mài)家的原因需要退款時(shí)，賣(mài)家可以通過(guò)退款接口將支付款退還給買(mǎi)家，微信支付將在收到退款請(qǐng)求并且驗(yàn)證成功之后，按照退款規(guī)則將支付款按原路退到買(mǎi)家?guī)ぬ?hào)上。

注意：

1.交易時(shí)間超過(guò)一年的訂單無(wú)法提交退款; 2、微信支付退款支持單筆交易分多次退款，多次退款需要提交原支付訂單的商戶(hù)訂單號(hào)和設(shè)置不同的退款單號(hào)。申請(qǐng)退款總金額不能超過(guò)訂單金額。 一筆退款失敗后重新提交，請(qǐng)不要更換退款單號(hào)，請(qǐng)使用原商戶(hù)退款單號(hào)。 3、請(qǐng)求頻率限制：150qps，即每秒鐘正常的申請(qǐng)退款請(qǐng)求次數(shù)不超過(guò)150次。錯(cuò)誤或無(wú)效請(qǐng)求頻率限制：6qps，即每秒鐘異?；蝈e(cuò)誤的退款申請(qǐng)請(qǐng)求不超過(guò)6次 4、每個(gè)支付訂單的部分退款次數(shù)不能超過(guò)50次

參數(shù)說(shuō)明

字段名變量名必填類(lèi)型示例值描述

子商戶(hù)號(hào)sub_mch_id是String(32)1900000109微信支付分配的子商戶(hù)號(hào)

隨機(jī)字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS隨機(jī)字符串，不長(zhǎng)于32位。推薦隨機(jī)數(shù)生成算法

微信訂單號(hào)transaction_id否String(32)1217752501201407033233368018微信訂單號(hào)。與商戶(hù)訂單號(hào)二選一填入。

商戶(hù)訂單號(hào)out_trade_no否String(32)1217752501201407033233368018商戶(hù)系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫(xiě)字母_-

商戶(hù)退款單號(hào)out_refund_no是String(64)1.21775E+27商戶(hù)系統(tǒng)內(nèi)部的退款單號(hào)，商戶(hù)系統(tǒng)內(nèi)部唯一，只能是數(shù)字、大小寫(xiě)字母_-

訂單金額total_fee是Int100訂單總金額，單位為分，只能為整數(shù)，詳見(jiàn)支付金額

申請(qǐng)退款金額refund_fee是Int100退款總金額，單位為分，只能為整數(shù)，可部分退款。詳見(jiàn)支付金額

貨幣種類(lèi)refund_fee_type否String(8)CNY貨幣類(lèi)型，符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，默認(rèn)人民幣：CNY，其他值列表詳見(jiàn)貨幣類(lèi)型

退款原因refund_desc否String(80)商品已售完若商戶(hù)傳入，會(huì)在下發(fā)給用戶(hù)的退款消息中體現(xiàn)退款原因

注意：若訂單退款金額≤1元，且屬于部分退款，則不會(huì)在退款消息中體現(xiàn)退款原因

退款資金來(lái)源refund_account否String(30)REFUND_SOURCE_RECHARGE_FUNDS僅針對(duì)老資金流商戶(hù)使用

REFUND_SOURCE_UNSETTLED_FUNDS---未結(jié)算資金退款(默認(rèn)使用未結(jié)算資金退款)

REFUND_SOURCE_RECHARGE_FUNDS---可用余額退款

返回值說(shuō)明

字段名變量名必填類(lèi)型示例值描述

返回狀態(tài)碼returnCode是String(16)SUCCESSSUCCESS/FAIL

返回信息returnMsg否String(128)簽名失敗返回信息，如非空，為錯(cuò)誤原因。如 簽名失敗、參數(shù)格式校驗(yàn)錯(cuò)誤

以下字段在returnCode為SUCCESS的時(shí)候有返回

字段名變量名必填類(lèi)型示例值描述

業(yè)務(wù)結(jié)果result_code是String(16)SUCCESSSUCCESS/FAIL

SUCCESS退款申請(qǐng)接收成功，結(jié)果通過(guò)退款查詢(xún)接口查詢(xún)

FAIL 提交業(yè)務(wù)失敗

錯(cuò)誤代碼err_code否String(32)SYSTEMERROR列表詳見(jiàn)錯(cuò)誤碼列表

錯(cuò)誤代碼描述err_code_des否String(128)系統(tǒng)超時(shí)結(jié)果信息描述

服務(wù)商的APPIDappid是String(32)wxd678efh567hg6787服務(wù)商商戶(hù)的APPID

商戶(hù)號(hào)mch_id是String(32)1230000109微信支付分配的商戶(hù)號(hào)

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

子商戶(hù)號(hào)sub_mch_id是String(32)1900000109微信支付分配的子商戶(hù)號(hào)

隨機(jī)字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS隨機(jī)字符串，不長(zhǎng)于32位

簽名sign是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS簽名，詳見(jiàn)簽名算法

微信訂單號(hào)transaction_id是String(32)1217752501201407033233368018微信訂單號(hào)

商戶(hù)訂單號(hào)out_trade_no是String(32)1217752501201407033233368018商戶(hù)系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫(xiě)字母_-

商戶(hù)退款單號(hào)out_refund_no是String(64)1217752501201407033233368018商戶(hù)系統(tǒng)內(nèi)部的退款單號(hào)，商戶(hù)系統(tǒng)內(nèi)部唯一，只能是數(shù)字、大小寫(xiě)字母_-

微信退款單號(hào)refund_id是String(32)1217752501201407033233368018微信退款單號(hào)

申請(qǐng)退款金額refund_fee是Int100退款總金額,單位為分,可以做部分退款

退款金額settlement_refund_fee否Int100去掉非充值代金券退款金額后的退款金額，退款金額=申請(qǐng)退款金額-非充值代金券退款金額，退款金額<=申請(qǐng)退款金額

訂單金額total_fee是Int100訂單總金額，單位為分，只能為整數(shù)，詳見(jiàn)支付金額

應(yīng)結(jié)訂單金額settlement_total_fee否Int100應(yīng)結(jié)訂單金額=訂單金額-免充值代金券金額，應(yīng)結(jié)訂單金額<=訂單金額。

貨幣種類(lèi)fee_type否String(8)CNY訂單金額貨幣類(lèi)型，符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，默認(rèn)人民幣：CNY，其他值列表詳見(jiàn)貨幣類(lèi)型

現(xiàn)金支付金額cash_fee是Int100現(xiàn)金支付金額，單位為分，只能為整數(shù)，詳見(jiàn)支付金額

現(xiàn)金退款金額cash_refund_fee否Int100現(xiàn)金退款金額，單位為分，只能為整數(shù)，詳見(jiàn)支付金額

代金券退款總金額coupon_refund_fee否Int100代金券退款金額<=退款金額，退款金額-代金券或立減優(yōu)惠退款金額為現(xiàn)金，說(shuō)明詳見(jiàn)代金券或立減優(yōu)惠

退款代金券使用數(shù)量coupon_refund_count否Int1退款代金券使用數(shù)量

代金券類(lèi)型coupon_type_$n否String(8)CASHCASH--充值代金券

NO_CASH---非充值代金券

訂單使用代金券時(shí)有返回(取值：CASH、NO_CASH)。$n為下標(biāo),從0開(kāi)始編號(hào)，舉例：coupon_type_0

錯(cuò)誤碼

名稱(chēng)描述原因解決方案

SYSTEMERROR接口返回錯(cuò)誤系統(tǒng)超時(shí)請(qǐng)不要更換商戶(hù)退款單號(hào)，請(qǐng)使用相同參數(shù)再次調(diào)用API。

BIZERR_NEED_RETRY退款業(yè)務(wù)流程錯(cuò)誤，需要商戶(hù)觸發(fā)重試來(lái)解決并發(fā)情況下，業(yè)務(wù)被拒絕，商戶(hù)重試即可解決請(qǐng)不要更換商戶(hù)退款單號(hào)，請(qǐng)使用相同參數(shù)再次調(diào)用API。

TRADE_OVERDUE訂單已經(jīng)超過(guò)退款期限訂單已經(jīng)超過(guò)可退款的最大期限(支付后一年內(nèi)可退款)請(qǐng)選擇其他方式自行退款

ERROR業(yè)務(wù)錯(cuò)誤申請(qǐng)退款業(yè)務(wù)發(fā)生錯(cuò)誤該錯(cuò)誤都會(huì)返回具體的錯(cuò)誤原因，請(qǐng)根據(jù)實(shí)際返回做相應(yīng)處理。

USER_ACCOUNT_ABNORMAL退款請(qǐng)求失敗用戶(hù)帳號(hào)注銷(xiāo)此狀態(tài)代表退款申請(qǐng)失敗，商戶(hù)可自行處理退款。

INVALID_REQ_TOO_MUCH無(wú)效請(qǐng)求過(guò)多連續(xù)錯(cuò)誤請(qǐng)求數(shù)過(guò)多被系統(tǒng)短暫屏蔽請(qǐng)檢查業(yè)務(wù)是否正常，確認(rèn)業(yè)務(wù)正常后請(qǐng)?jiān)?分鐘后再來(lái)重試

NOTENOUGH余額不足商戶(hù)可用退款余額不足此狀態(tài)代表退款申請(qǐng)失敗，商戶(hù)可根據(jù)具體的錯(cuò)誤提示做相應(yīng)的處理。

INVALID_TRANSACTIONID無(wú)效transaction_id請(qǐng)求參數(shù)未按指引進(jìn)行填寫(xiě)請(qǐng)求參數(shù)錯(cuò)誤，檢查原交易號(hào)是否存在或發(fā)起支付交易接口返回失敗

PARAM_ERROR參數(shù)錯(cuò)誤請(qǐng)求參數(shù)未按指引進(jìn)行填寫(xiě)請(qǐng)求參數(shù)錯(cuò)誤，請(qǐng)重新檢查再調(diào)用退款申請(qǐng)

APPID_NOT_EXISTAPPID不存在參數(shù)中缺少APPID請(qǐng)檢查APPID是否正確

MCHID_NOT_EXISTMCHID不存在參數(shù)中缺少M(fèi)CHID請(qǐng)檢查MCHID是否正確

REQUIRE_POST_METHOD請(qǐng)使用post方法未使用post傳遞參數(shù)請(qǐng)檢查請(qǐng)求參數(shù)是否通過(guò)post方法提交

SIGNERROR簽名錯(cuò)誤參數(shù)簽名結(jié)果不正確請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求

XML_FORMAT_ERRORXML格式錯(cuò)誤XML格式錯(cuò)誤請(qǐng)檢查XML參數(shù)格式是否正確

FREQUENCY_LIMITED頻率限制2個(gè)月之前的訂單申請(qǐng)退款有頻率限制該筆退款未受理，請(qǐng)降低頻率后重試

NOAUTH異常IP請(qǐng)求不予受理請(qǐng)求ip異常如果是動(dòng)態(tài)ip，請(qǐng)登錄商戶(hù)平臺(tái)后臺(tái)關(guān)閉ip安全配置;

如果是靜態(tài)ip，請(qǐng)確認(rèn)商戶(hù)平臺(tái)配置的請(qǐng)求ip 在不在配的ip列表里