商圈會(huì)員在商圈小程序內(nèi)打開“商圈會(huì)員快速積分”插件并完成會(huì)員積分服務(wù)授權(quán)后，微信會(huì)把會(huì)員的授權(quán)結(jié)果通知給商圈商戶。

# 接口說(shuō)明

支持商戶： 【普通商戶】

請(qǐng)求方式： 【POST】

回調(diào)URL： 由商圈側(cè)提供接口鏈接地址，必須為HTTPS協(xié)議。如果鏈接無(wú)法訪問，商戶將無(wú)法接收到微信通知。 通知URL必須為直接可訪問的URL，不能攜帶參數(shù)。示例："https://pay.wechatpay.cn/wxpay/pay.action"

# 通知規(guī)則

會(huì)員用戶在商圈小程序內(nèi)完成授權(quán)后，微信會(huì)把用戶授權(quán)信息及狀態(tài)通知給商圈商戶，商戶需要接收處理，并返回應(yīng)答。出于安全的考慮，我們對(duì)數(shù)據(jù)進(jìn)行了加密，商戶需要先對(duì)通知數(shù)據(jù)進(jìn)行解密，才能得到支付結(jié)果數(shù)據(jù)。

對(duì)后臺(tái)通知交互時(shí)，如果微信收到商戶的應(yīng)答不是成功或超時(shí)，微信認(rèn)為通知失敗，微信會(huì)通過(guò)一定的策略重新發(fā)起通知，盡可能提高通知的成功率，但微信不保證通知最終能成功。（通知頻率為1s/10s/10s/10s/10s/10s/1m/1m/1m/1m，總計(jì)4m51s）

# 通知報(bào)文

商圈會(huì)員積分服務(wù)授權(quán)結(jié)果通知是以POST方法訪問商戶設(shè)置的通知URL，通知的數(shù)據(jù)以JSON格式通過(guò)請(qǐng)求主體（BODY）傳輸。通知的數(shù)據(jù)包括了加密的用戶OpenID、授權(quán)類型、授權(quán)狀態(tài)等詳情。

# 步驟說(shuō)明

# 步驟一：驗(yàn)證簽名

微信支付會(huì)對(duì)發(fā)送給商戶的通知進(jìn)行簽名，并將簽名值放在通知的HTTP頭Wechatpay-Signature。商戶應(yīng)當(dāng)驗(yàn)證簽名，以確認(rèn)請(qǐng)求來(lái)自微信，而不是其他的第三方。簽名驗(yàn)證的算法請(qǐng)參考 《微信支付API v3簽名驗(yàn)證》。

# 步驟二：參數(shù)解密

為了保證安全性，微信支付在回調(diào)通知，對(duì)關(guān)鍵信息進(jìn)行了AES-256-GCM加密。商戶應(yīng)當(dāng)按照以下的流程進(jìn)行解密關(guān)鍵信息，解密的流程：

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

# 字段說(shuō)明

1{
2    "id":"EV-2018022511223320873",
3    "create_time":"2015-05-20T13:29:35+08:00",
4    "resource_type":"encrypt-resource",
5    "event_type":"MALL_AUTH.ACTIVATE_CARD",
6    "resource" : {
7        "algorithm":"AEAD_AES_256_GCM",
8        "ciphertext": "...",
9        "original_type": "discount_card",
10        "nonce": "...",
11        "associated_data": ""
12    },
13   "summary": "會(huì)員卡激活通知"
14}

1{
2    "openid": "oWmnN4xxxxxxxxxxe92NHIGf1xd8",
3    "code": "478515832665",
4    "mchid": "1230000109",
5    "auth_type": "REGISTERED_MODE "
6}

1{  
2    "code": "FAIL",
3    "message": "失敗"
4}