應(yīng)用場景

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

注意：

1、交易時(shí)間超過一年的訂單無法提交退款；

2、微信支付退款支持單筆交易分多次退款，多次退款需要提交原支付訂單的商戶訂單號和設(shè)置不同的退款單號。申請退款總金額不能超過訂單金額。一筆退款失敗后重新提交，請不要更換退款單號，請使用原商戶退款單號。

3、請求頻率限制：150qps，即每秒鐘正常的申請退款請求次數(shù)不超過150次

4、每個(gè)支付訂單的部分退款次數(shù)不能超過50次

5、本接口支持單品優(yōu)惠訂單全額退款和單品優(yōu)惠訂單部分退款，推薦使用本接口，如果使用不支持單品優(yōu)惠部分退款的歷史接口，請看http://www.tg885.com/wiki/doc/api/jsapi_sl.php?chapter=9_4

接口地址

https://api.mch.weixin.qq.com/secapi/pay/refundv2

https://api2.mch.weixin.qq.com/secapi/pay/refundv2(備用域名)見跨城冗災(zāi)方案

是否需要證書

請求需要雙向證書。詳見證書使用

請求參數(shù)

字段名	變量名	必填	類型	示例值	描述
商品詳情	detail	否	String(6000)	示例見下文	退款包含的商品列表信息，全額退款可不傳，必須按照規(guī)范上傳，JSON格式，詳見下文【退款包含的商品列表信息】
其他字段列表見申請退款A(yù)PI（普通商戶）申請退款A(yù)PI（服務(wù)商）

字段名

變量名

必填

類型

示例值

描述

商品詳情

detail

否

String(6000)

示例見下文

退款包含的商品列表信息，全額退款可不傳，必須按照規(guī)范上傳，JSON格式，詳見下文【退款包含的商品列表信息】

其他字段列表見

申請退款A(yù)PI（普通商戶）

申請退款A(yù)PI（服務(wù)商）

退款包含的商品列表信息detail字段列表說明：

字段名	變量名	必填	類型	示例值	描述
商品列表	goods_detail	是	String	示例見下文	商品信息，使用Json數(shù)組格式提交

商品列表goods_detail字段列表說明：

字段名	變量名	必填	類型	示例值	描述
商品編碼	goods_id	是	String(32)	商品編碼	由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成
微信支付商品編碼	wxpay_goods_id	否	String(32)	1001	微信支付定義的統(tǒng)一商品編號（沒有可不傳）
商品名稱	goods_name	否	String(256)	iPhone6s 16G	商品的實(shí)際名稱
商品退款金額	refund_amount	是	int	528800	商品退款金額
商品退貨數(shù)量	refund_quantity	是	int	1	單品的退款數(shù)量
商品單價(jià)	price	是	int	528800	單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(jià)(例如：用戶對一筆100元的訂單使用了商場發(fā)的優(yōu)惠券100-50，則活動(dòng)商品的單價(jià)應(yīng)為原單價(jià)-50)

detail字段值舉例如下：

{
"goods_detail": [
{
"goods_id": "商品編碼",
"wxpay_goods_id": "1001",
"goods_name": "iPhone6s 16G",
"refund_amount": 528800,
"refund_quantity": 1,
"price": 528800
},
{
"goods_id": "商品編碼",
"wxpay_goods_id": "1001",
"goods_name": "iPhone6s 16G",
"refund_amount": 528800,
"refund_quantity": 1,
"price": 608800
}
]
}

提交退款數(shù)據(jù)舉例如下:

<xml>
<appid>wx2421b1c4370ec43b</appid>
<mch_id>10000100</mch_id>
<nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
<notify_url>https://weixin.qq.com/</notify_url>
<out_refund_no>1415701182</out_refund_no>
<out_trade_no>1415757673</out_trade_no>
<refund_fee>1</refund_fee>
<total_fee>1</total_fee>
<transaction_id></transaction_id>
<detail>{"goods_detail":[{"goods_id":"商品編碼","wxpay_goods_id":"1001","goods_name":"iPhone6s
16G","refund_amount":528800,"refund_quantity":1,"price":528800},{"goods_id":"商品編碼","wxpay_goods_id":"1001","goods_name":"iPhone6s
16G","refund_amount" ":528800,"refund_quantity":1,"price":608800}]}</ detail>
<sign>FE56DD4AA85C0EECA82C35595A69E153</sign>
</xml>

返回結(jié)果

字段名	變量名	必填	類型	示例值	描述
返回狀態(tài)碼	return_code	是	String(16)	SUCCESS	SUCCESS/FAIL
返回信息	return_msg	否	String(128)	簽名失敗	返回信息，如非空，為錯(cuò)誤原因簽名失敗參數(shù)格式校驗(yàn)錯(cuò)誤

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

字段名	變量名	必填	類型	示例值	描述
其他字段列表見申請退款A(yù)PI（普通商戶）申請退款A(yù)PI（服務(wù)商）下單時(shí)傳了version，返回參數(shù)會有差異，詳情參考：《注意事項(xiàng)》
營銷詳情	promotion_detail	否	String(6000)	示例見下文	營銷詳情列表，使返回值為Json格式

字段名

變量名

必填

類型

示例值

描述

其他字段列表見

申請退款A(yù)PI（普通商戶）

申請退款A(yù)PI（服務(wù)商）

下單時(shí)傳了version，返回參數(shù)會有差異，詳情參考：《注意事項(xiàng)》

營銷詳情

promotion_detail

否

String(6000)

示例見下文

營銷詳情列表，使返回值為Json格式

優(yōu)惠活動(dòng)promotion_detail字段列表說明：

字段名	變量名	必填	類型	示例值	描述
券ID	promotion_id	是	String(32)	109519	券或者立減優(yōu)惠id
優(yōu)惠范圍	scope	是	String(32)	SINGLE	GLOBAL- 全場代金券 SINGLE- 單品優(yōu)惠
優(yōu)惠類型	type	是	String(32)	DISCOUNT	COUPON- 代金券，需要走結(jié)算資金的充值型代金券,（境外商戶券幣種與支付幣種一致） DISCOUNT- 優(yōu)惠券，不走結(jié)算資金的免充值型優(yōu)惠券，（境外商戶券幣種與標(biāo)價(jià)幣種一致
代金券退款金額	refund_amount	是	int	100	代金券退款金額<=退款金額，退款金額-代金券或立減優(yōu)惠退款金額為現(xiàn)金，說明詳見代金券或立減優(yōu)惠
商品列表	goods_detail	否	String	見下文	商品信息，使用Json格式

商品列表goods_detail字段列表說明：

字段名	變量名	必填	類型	示例值	描述
商品編碼	goods_id	是	String(32)	商品編碼	由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成
優(yōu)惠退款金額	refund_amount	是	int	528800	優(yōu)惠退款金額
商品退貨數(shù)量	refund_quantity	是	int	1	單品的退貨數(shù)量
商品單價(jià)	price	是	int	528800	單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(jià)(例如：用戶對一筆100元的訂單使用了商場發(fā)的優(yōu)惠券100-50，則活動(dòng)商品的單價(jià)應(yīng)為原單價(jià)-50)

promotion_detail字段值舉例如下：

{
"promotion_detail":[
{
"promotion_id":"109519",
"scope":"SINGLE",
"type":"DISCOUNT",
"refund_amout":5,
"goods_detail":[
{
"goods_id":"a_goods1",
"refund_quantity":7,
"price":1,
"refund_amount":4
},
{
"goods_id":"a_goods2",
"refund_quantity":1,
"price":2,
"refund_amount":1
}
]
}
]

}

返回舉例如下：

<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wx2421b1c4370ec43b]]></appid>
<mch_id><![CDATA[10000100]]></mch_id>
<nonce_str><![CDATA[NfsMFbUFpdbEhPXP]]></nonce_str>
<sign><![CDATA[B7274EB9F8925EB93100DD2085FA56C0]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
<transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
<out_trade_no><![CDATA[1415757673]]></out_trade_no>
<out_refund_no><![CDATA[1415701182]]></out_refund_no>
<refund_id><![CDATA[2008450740201411110000174436]]></refund_id>
<refund_channel><![CDATA[]]></refund_channel>
<total_fee>1</total_fee >
<refund_fee>1</refund_fee>
<cash_fee>1</cash_fee >
<promotion_detail>{"promotion_detail":[{"promotion_id":"109519","scope":"SINGLE","type":"DISCOUNT","refund_amout":5,"goods_detail":[{"goods_id":"a_goods1","refund_quantity":7,"price":1,"refund_amount":4},{"goods_id":"a_goods2","refund_quantity":1,"price":2,"refund_amount":1}]}]}</promotion_detail>
</xml>

錯(cuò)誤碼

名稱	描述	原因	解決方案
ERROR	單品存在不同的單價(jià)，建議走整單退	退款請求參數(shù)中g(shù)oods_id出現(xiàn)不同單價(jià)	1、下單時(shí)，同一個(gè)goods_id，其price應(yīng)該相同 2、退款時(shí)把goods_id相同且price不同的單品分別進(jìn)行退款
	單品金額超過訂單金額，請全額退款	退款單品金額超過訂單金額	1、下單時(shí)，商戶所傳的單品信息goods_detail，滿足單品紀(jì)錄的unit_price * quantity的總和等于amount.total 2、檢查退款時(shí)傳入的訂單金額與單品金額是否有誤
	goods_id出現(xiàn)多次，建議調(diào)整退單品參數(shù)或者全額退	指定退款的單品，不能出現(xiàn)重復(fù)，未滿足業(yè)務(wù)規(guī)則	退款請求時(shí)把單品做合并
	請使用全額退款	該筆訂單不支持單品部分退，請使用全額退款	請使用全額退款
	輸入的金額較低無法退款成功，建議將本訂單進(jìn)行整單退款。	輸入的金額較低無法退款	建議將本訂單進(jìn)行整單退款
	商品編碼不存在于訂單中	退款單品只能是訂單下單時(shí)傳入goods_id的單品	只能退下單時(shí)傳入的單品
SYSTEMERROR	接口返回錯(cuò)誤	系統(tǒng)超時(shí)	請用相同參數(shù)再次調(diào)用API
INVALID_TRANSACTIONID	無效transaction_id	請求參數(shù)未按指引進(jìn)行填寫	請求參數(shù)錯(cuò)誤，檢查原交易號是否存在或發(fā)起支付交易接口返回失敗（明確錯(cuò)誤，請勿重試）
PARAM_ERROR	參數(shù)錯(cuò)誤	請求參數(shù)未按指引進(jìn)行填寫	請求參數(shù)錯(cuò)誤，請重新檢查再調(diào)用退款申請（明確錯(cuò)誤，請勿重試）
APPID_NOT_EXIST	APPID不存在	參數(shù)中缺少APPID	請檢查APPID是否正確（明確錯(cuò)誤，請勿重試）
MCHID_NOT_EXIST	MCHID不存在	參數(shù)中缺少M(fèi)CHID	請檢查MCHID是否正確（明確錯(cuò)誤，請勿重試）
APPID_MCHID_NOT_MATCH	appid和mch_id不匹配	appid和mch_id不匹配	請確認(rèn)appid和mch_id是否匹配
REQUIRE_POST_METHOD	請使用post方法	未使用post傳遞參數(shù)	請檢查請求參數(shù)是否通過post方法提交（明確錯(cuò)誤，請勿重試）
SIGNERROR	簽名錯(cuò)誤	參數(shù)簽名結(jié)果不正確	請檢查簽名參數(shù)和方法是否都符合簽名算法要求（明確錯(cuò)誤，請勿重試）
XML_FORMAT_ERROR	XML格式錯(cuò)誤	XML格式錯(cuò)誤	請檢查XML參數(shù)格式是否正確（明確錯(cuò)誤，請勿重試）
TRADE_OVERDUE	訂單已經(jīng)超過退款期限	訂單已經(jīng)超過可退款的最大期限(支付后一年內(nèi)可退款)	請選擇其他方式自行退款（明確錯(cuò)誤，請勿重試）
USER_ACCOUNT_ABNORMAL	退款請求失敗	用戶賬號注銷	此狀態(tài)代表退款申請失敗，商戶可自行處理退款。（明確錯(cuò)誤，請勿重試）
ORDERNOTEXIST	訂單號不存在	缺少有效的訂單號	請檢查你的訂單號是否正確且是否已支付，未支付的訂單不能發(fā)起退款（明確錯(cuò)誤，請勿重試）
CERT_ERROR	證書校驗(yàn)錯(cuò)誤	請檢查證書是否正確，證書是否過期或作廢。	請檢查證書是否正確，證書是否過期或作廢。（明確錯(cuò)誤，請勿重試）
REFUND_FEE_MISMATCH	訂單金額或退款金額與之前請求不一致，請核實(shí)后再試	訂單金額或退款金額與之前請求不一致，請核實(shí)后再試	訂單金額或退款金額與之前請求不一致，請核實(shí)后再試（明確錯(cuò)誤，請勿重試）
INVALID_REQUEST	請求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則	此狀態(tài)代表退款申請失敗，商戶可根據(jù)具體的錯(cuò)誤提示做相應(yīng)的處理。	此狀態(tài)代表退款申請失敗，商戶可根據(jù)具體的錯(cuò)誤提示做相應(yīng)的處理。（明確錯(cuò)誤，請勿重試）

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

微信支付服務(wù)商平臺