微信開(kāi)發(fā)中CloudPay.queryRefund()怎么用

這篇文章給大家分享的是有關(guān)微信開(kāi)發(fā)中CloudPay.queryRefund()怎么用的內(nèi)容。小編覺(jué)得挺實(shí)用的，因此分享給大家做個(gè)參考，一起跟隨小編過(guò)來(lái)看看吧。

CloudPay.queryRefund()

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

查詢(xún)退款

說(shuō)明

提交退款申請(qǐng)后，通過(guò)調(diào)用該接口查詢(xún)退款狀態(tài)。退款有一定延時(shí)，用零錢(qián)支付的退款20分鐘內(nèi)到賬，銀行卡支付的退款3個(gè)工作日后重新查詢(xún)退款狀態(tài)。 注意：如果單個(gè)支付訂單部分退款次數(shù)超過(guò)20次請(qǐng)使用退款單號(hào)查詢(xún)* 分頁(yè)查詢(xún)*

當(dāng)一個(gè)訂單部分退款超過(guò)10筆后，商戶(hù)用微信訂單號(hào)或商戶(hù)訂單號(hào)調(diào)退款查詢(xún)API查詢(xún)退款時(shí)，默認(rèn)返回前10筆和total_refund_count(退款單總筆數(shù))。商戶(hù)需要查詢(xún)同一訂單下超過(guò)10筆的退款單時(shí)，可傳入訂單號(hào)及offset來(lái)查詢(xún)，微信支付會(huì)返回offset及后面的10筆，以此類(lèi)推。當(dāng)商戶(hù)傳入的offset超過(guò)total_refund_count，則系統(tǒng)會(huì)返回報(bào)錯(cuò)PARAM_ERROR。

舉例：

一筆訂單下的退款單有36筆，當(dāng)商戶(hù)想查詢(xún)第25筆時(shí)，可傳入訂單號(hào)及offset=24，微信支付平臺(tái)會(huì)返回第25筆到第35筆的退款單信息，或商戶(hù)可直接傳入退款單號(hào)查詢(xún)退款

參數(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(28)1217752501201407033233368018微信訂單號(hào)查詢(xún)的優(yōu)先級(jí)是： refund_id > out_refund_no > transaction_id > out_trade_no

商戶(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)

偏移量offset否Int15偏移量，當(dāng)部分退款次數(shù)超過(guò)10次時(shí)可使用，表示返回的查詢(xún)結(jié)果從這個(gè)偏移量開(kāi)始取記錄

refund_id、out_refund_no、out_trade_no、transaction_id四個(gè)參數(shù)必填一個(gè)，如果同時(shí)存在優(yōu)先級(jí)為： refund_id>out_refund_no>transaction_id>out_trade_no

返回值說(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)

錯(cuò)誤碼err_code是String(32)SYSTEMERROR錯(cuò)誤碼詳見(jiàn)第6節(jié)

錯(cuò)誤描述err_code_des是String(128)系統(tǒng)錯(cuò)誤結(jié)果信息描述

服務(wù)商的APPIDappid是String(32)wxd678efh667hg6787服務(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)C380BEC2BFD727A4B6845133519F3AD6簽名，詳見(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ě)字母_-

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

應(yīng)結(jié)訂單金額settlement_total_fee否Int100當(dāng)訂單使用了免充值型優(yōu)惠券后返回該參數(shù)，應(yīng)結(jié)訂單金額=訂單金額-免充值優(yōu)惠券金額。

貨幣種類(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)支付金額

退款筆數(shù)refund_count是Int1當(dāng)前返回退款筆數(shù)

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

微信退款單號(hào)refund_id_$n是String(32)1217752501201407033233368018微信退款單號(hào)

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

BALANCE—退回到余額

OTHER_BALANCE—原賬戶(hù)異常退到其他余額賬戶(hù)

OTHER_BANKCARD—原銀行卡異常退到其他銀行卡

訂單總退款次數(shù)total_refund_count否Int35訂單總共已發(fā)生的部分退款次數(shù)，當(dāng)請(qǐng)求參數(shù)傳入offset后有返回

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

退款金額settlement_refund_fee_$n否Int100退款金額=申請(qǐng)退款金額-非充值代金券退款金額，退款金額<=申請(qǐng)退款金額

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

NO_CASH---非充值代金券

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

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

退款代金券使用數(shù)量coupon_refund_count_$n否Int1退款代金券使用數(shù)量 ,$n為下標(biāo),從0開(kāi)始編號(hào)

退款代金券IDcoupon_refund_id_$n_$m否String(20)10000退款代金券ID, $n為下標(biāo)，$m為下標(biāo)，從0開(kāi)始編號(hào)

單個(gè)代金券退款金額coupon_refund_fee_$n_$m否Int100單個(gè)退款代金券支付金額, $n為下標(biāo)，$m為下標(biāo)，從0開(kāi)始編號(hào)

退款狀態(tài)refund_status_$n是String(16)SUCCESS退款狀態(tài)：SUCCESS&mdash;退款成功

REFUNDCLOSE&mdash;退款關(guān)閉。

PROCESSING&mdash;退款處理中

CHANGE&mdash;退款異常，退款到銀行發(fā)現(xiàn)用戶(hù)的卡作廢或者凍結(jié)了，導(dǎo)致原路退款銀行卡失敗，可前往商戶(hù)平臺(tái)(pay.weixin.qq.com)-交易中心，手動(dòng)處理此筆退款。$n為下標(biāo)，從0開(kāi)始編號(hào)。

退款資金來(lái)源refund_account_$n否String(30)REFUND_SOURCE_RECHARGE_FUNDSREFUND_SOURCE_RECHARGE_FUNDS---可用余額退款/基本賬戶(hù)

REFUND_SOURCE_UNSETTLED_FUNDS---未結(jié)算資金退款

$n為下標(biāo)，從0開(kāi)始編號(hào)。

退款入賬賬戶(hù)refund_recv_accout_$n是String(64)招商銀行信用卡0403取當(dāng)前退款單的退款入賬方

1)退回銀行卡：

{銀行名稱(chēng)}{卡類(lèi)型}{卡尾號(hào)}

2)退回支付用戶(hù)零錢(qián):

支付用戶(hù)零錢(qián)

3)退還商戶(hù):

商戶(hù)基本賬戶(hù)

商戶(hù)結(jié)算銀行賬戶(hù)

4)退回支付用戶(hù)零錢(qián)通:

支付用戶(hù)零錢(qián)通

退款成功時(shí)間refund_success_time_$n否String(20)2016-07-25 15:26:26退款成功時(shí)間，當(dāng)退款狀態(tài)為退款成功時(shí)有返回。$n為下標(biāo)，從0開(kāi)始編號(hào)。

錯(cuò)誤碼

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

SYSTEMERROR接口返回錯(cuò)誤系統(tǒng)超時(shí)請(qǐng)嘗試再次掉調(diào)用API。

REFUNDNOTEXIST退款訂單查詢(xún)失敗訂單號(hào)錯(cuò)誤或訂單狀態(tài)不正確請(qǐng)檢查訂單號(hào)是否有誤以及訂單狀態(tài)是否正確，如：未支付、已支付未退款

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)檢查參數(shù)再調(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ù)格式是否正確

感謝各位的閱讀！關(guān)于“微信開(kāi)發(fā)中CloudPay.queryRefund()怎么用”這篇文章就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，讓大家可以學(xué)到更多知識(shí)，如果覺(jué)得文章不錯(cuò)，可以把它分享出去讓更多的人看到吧！