接口說明

適用對象：直連商戶 服務商 渠道商

請求URL：該鏈接是通過【設置商家券事件通知地址API】提交notify_url參數(shù)設置，必須為https協(xié)議。如果鏈接無法訪問，商戶將無法接收到微信通知。 通知url必須為直接可訪問的url，不能攜帶參數(shù)。示例：“http://www.tg885.com/wxpay/pay.action”

接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml

通知規(guī)則

領券完成后，微信會把相關支付結果和用戶信息發(fā)送給商戶，商戶需要接收處理，并按照文檔規(guī)范返回應答。出于安全的考慮，我們對支付結果數(shù)據(jù)進行了加密，商戶需要先對通知數(shù)據(jù)進行解密，才能得到支付結果數(shù)據(jù)。

對后臺通知交互時，如果微信收到應答不是成功或超時，微信認為通知失敗，微信會通過一定的策略定期重新發(fā)起通知，盡可能提高通知的成功率，但微信不保證通知最終能成功。（通知頻率為60s/次 - 總計11次 ）

通知報文

領券結果通知是以POST 方法訪問商戶設置的通知url，通知的數(shù)據(jù)以JSON 格式通過請求主體（BODY）傳輸。通知的數(shù)據(jù)包括了加密的支付結果詳情。

下面詳細描述對通知數(shù)據(jù)進行解密的流程：

1. 1、用商戶平臺上設置的APIv3密鑰【微信商戶平臺—>賬戶設置—>API安全—>設置APIv3密鑰】，記為key。
2. 2、針對resource.algorithm中描述的算法（目前為AEAD_AES_256_GCM），取得對應的參數(shù)nonce和associated_data。
3. 3、使用key、nonce和associated_data，對數(shù)據(jù)密文resource.ciphertext進行解密，得到JSON形式的資源對象。

通知參數(shù)

通知簽名

加密不能保證通知請求來自微信。微信會對發(fā)送給商戶的通知進行簽名，并將簽名值放在通知的HTTP頭Wechatpay-Signature。商戶應當驗證簽名，以確認請求來自微信，而不是其他的第三方。簽名驗證的算法請參考 《微信支付API v3簽名驗證》。

回調示例

領券成功通知結果

{ 
    "id":"8b33f79f-8869-5ae5-b41b-3c0b59f957d0",
    "create_time":"2019-12-12T16:54:38+08:00",
    "resource_type":"encrypt-resource",
    "event_type":"COUPON.SEND",
    "summary":"商家券領券通知",
    "resource":{
        "original_type":"coupon",
        "algorithm":"AEAD_AES_256_GCM",
        "ciphertext":"xxx",
        "associated_data":"coupon",
        "nonce":"j9g1wAzF9Xn1"
     } 
} 

商戶對resource對象進行解密后，得到的資源對象示例

{   
	"event_type":"EVENT_TYPE_BUSICOUPON_SEND",
	"coupon_code":"1227944959000000911017",
	"stock_id":"1286950000000039",
	"send_time":"2019-12-17T10:35:53+08:00",
	"openid":"odXnH1CJjeQoWTld48db-pnxs-Wg",
	"unionid":"oOuyajgxj0oVwjocSoQm6mp7PGKw",
	"send_channel":"BUSICOUPON_SEND_CHANNEL_PAYGIFT", 
	# 此處原來為BUSICOUPON_SEND_CHANNEL_MINIAPP
	"send_merchant":"98568888",
	"attach_info":"{
		\"transaction_id\":\"4200000462220200226114599\",\"act_code\":\"540358695\"}"
	 # attach_info只有在支付有禮渠道才會有，其他渠道沒有
}

領券成功通知參數(shù)

通知應答

支付通知http應答碼為200或204才會當作正常接收，當回調處理異常時，應答的HTTP狀態(tài)碼應為500，或者4xx。

注意：當商戶后臺應答失敗時，微信支付將記錄下應答的報文，建議商戶按照以下格式返回。

{   
    "code": "ERROR_NAME",
    "message": "ERROR_DESCRIPTION",
}