[轉]微信支付 支付結果通用通知

本文轉自：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_7

應用場景

支付完成後，微信會把相關支付結果和用戶信息發送給商戶，商戶須要接收處理，並返回應答。

對後臺通知交互時，若是微信收到商戶的應答不是成功或超時，微信認爲通知失敗，微信會經過必定的策略按期從新發起通知，儘量提升通知的成功率，但微信不保證通知最終能成功。 （通知頻率爲15/15/30/180/1800/1800/1800/1800/3600，單位：秒）

注意：一樣的通知可能會屢次發送給商戶系統。商戶系統必須可以正確處理重複的通知。     

推薦的作法是，當收到通知進行處理時，首先檢查對應業務數據的狀態，判斷該通知是否已經處理過，若是沒有處理過再進行處理，若是處理過直接返回結果成功。在對業務數據進行狀態檢查和處理以前，要採用數據鎖進行併發控制，以免函數重入形成的數據混亂。

特別提醒：商戶系統對於支付結果通知的內容必定要作簽名驗證,並校驗返回的訂單金額是否與商戶側的訂單金額一致，防止數據泄漏致使出現「假通知」，形成資金損失。    

技術人員可登進微信商戶後臺掃描加入接口報警羣。

接口連接

該連接是經過【統一下單API】中提交的參數notify_url設置，若是連接沒法訪問，商戶將沒法接收到微信通知。

通知url必須爲直接可訪問的url，不能攜帶參數。示例：notify_url：「https://pay.weixin.qq.com/wxpay/pay.action」

是否須要證書

不須要。

通知參數

字段名	變量名	必填	類型	示例值	描述
返回狀態碼	return_code	是	String(16)	SUCCESS	SUCCESS/FAIL 此字段是通訊標識，非交易標識，交易是否成功須要查看result_code來判斷
返回信息	return_msg	否	String(128)	簽名失敗	返回信息，如非空，爲錯誤緣由 簽名失敗 參數格式校驗錯誤

如下字段在return_code爲SUCCESS的時候有返回

字段名	變量名	必填	類型	示例值	描述
小程序ID	appid	是	String(32)	wx8888888888888888	微信分配的小程序ID
商戶號	mch_id	是	String(32)	1900000109	微信支付分配的商戶號
設備號	device_info	否	String(32)	013467007045764	微信支付分配的終端設備號，
隨機字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	隨機字符串，不長於32位
簽名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	簽名，詳見簽名算法
簽名類型	sign_type	否	String(32)	HMAC-SHA256	簽名類型，目前支持HMAC-SHA256和MD5，默認爲MD5
業務結果	result_code	是	String(16)	SUCCESS	SUCCESS/FAIL
錯誤代碼	err_code	否	String(32)	SYSTEMERROR	錯誤返回的信息描述
錯誤代碼描述	err_code_des	否	String(128)	系統錯誤	錯誤返回的信息描述
用戶標識	openid	是	String(128)	wxd930ea5d5a258f4f	用戶在商戶appid下的惟一標識
是否關注公衆帳號	is_subscribe	否	String(1)	Y	用戶是否關注公衆帳號，Y-關注，N-未關注，僅在公衆帳號類型支付有效
交易類型	trade_type	是	String(16)	JSAPI	JSAPI、NATIVE、APP
付款銀行	bank_type	是	String(16)	CMC	銀行類型，採用字符串類型的銀行標識，銀行類型見銀行列表
訂單金額	total_fee	是	Int	100	訂單總金額，單位爲分
應結訂單金額	settlement_total_fee	否	Int	100	應結訂單金額=訂單金額-非充值代金券金額，應結訂單金額<=訂單金額。
貨幣種類	fee_type	否	String(8)	CNY	貨幣類型，符合ISO4217標準的三位字母代碼，默認人民幣：CNY，其餘值列表詳見貨幣類型
現金支付金額	cash_fee	是	Int	100	現金支付金額訂單現金支付金額，詳見支付金額
現金支付貨幣類型	cash_fee_type	否	String(16)	CNY	貨幣類型，符合ISO4217標準的三位字母代碼，默認人民幣：CNY，其餘值列表詳見貨幣類型
代金券金額	coupon_fee	否	Int	10	代金券金額<=訂單金額，訂單金額-代金券金額=現金支付金額，詳見支付金額
代金券使用數量	coupon_count	否	Int	1	代金券使用數量
代金券類型	coupon_type_$n	否	Int	CASH	CASH--充值代金券 NO_CASH---非充值代金券 僅在使用了免充值代金券時有返回（取值：CASH、NO_CASH）。$n爲下標,從0開始編號，舉例：coupon_type_0
代金券ID	coupon_id_$n	否	String(20)	10000	代金券ID,$n爲下標，從0開始編號
單個代金券支付金額	coupon_fee_$n	否	Int	100	單個代金券支付金額,$n爲下標，從0開始編號
微信支付訂單號	transaction_id	是	String(32)	1217752501201407033233368018	微信支付訂單號
商戶訂單號	out_trade_no	是	String(32)	1212321211201407033568112322	商戶系統的訂單號，與請求一致。
商家數據包	attach	否	String(128)	123456	商家數據包，原樣返回
支付完成時間	time_end	是	String(14)	20141030133525	支付完成時間，格式爲yyyyMMddHHmmss，如2009年12月25日9點10分10秒錶示爲20091225091010。其餘詳見時間規則

舉例以下：

<xml>           <appid><![CDATA[wx2421b1c4370ec43b]]></appid>           <attach><![CDATA[支付測試]]></attach>           <bank_type><![CDATA[CFT]]></bank_type>           <fee_type><![CDATA[CNY]]></fee_type>           <is_subscribe><![CDATA[Y]]></is_subscribe>           <mch_id><![CDATA[10000100]]></mch_id>           <nonce_str><![CDATA[5d2b6c2a8db53831f7eda20af46e531c]]></nonce_str>           <openid><![CDATA[oUpF8uMEb4qRXf22hE3X68TekukE]]></openid>           <out_trade_no><![CDATA[1409811653]]></out_trade_no>           <result_code><![CDATA[SUCCESS]]></result_code>           <return_code><![CDATA[SUCCESS]]></return_code>           <sign><![CDATA[B552ED6B279343CB493C5DD0D78AB241]]></sign>           <sub_mch_id><![CDATA[10000100]]></sub_mch_id>           <time_end><![CDATA[20140903131540]]></time_end>           <total_fee>1</total_fee>           <trade_type><![CDATA[JSAPI]]></trade_type>           <transaction_id><![CDATA[1004400740201409030005092168]]></transaction_id>         </xml>

返回參數

商戶處理後同步返回給微信參數：

字段名	變量名	必填	類型	示例值	描述
返回狀態碼	return_code	是	String(16)	SUCCESS	SUCCESS/FAIL SUCCESS表示商戶接收通知成功並校驗成功
返回信息	return_msg	否	String(128)	OK	返回信息，如非空，爲錯誤緣由： 簽名失敗 參數格式校驗錯誤

舉例以下：

<xml>

  <return_code><![CDATA[SUCCESS]]></return_code>           <return_msg><![CDATA[OK]]></return_msg>         </xml>