接口說明

適用對象：直連商戶

請求URL：該鏈接：普通授權(quán)模式是通過[商戶入駐配置申請表]提交service_notify_url設(shè)置，預(yù)授權(quán)模式是通過[商戶預(yù)授權(quán)]提交的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ī)則

用戶開啟/解除授權(quán)完成后，微信后臺會把用戶的openid和商戶的out_request_no（授權(quán)服務(wù)專屬）的關(guān)聯(lián)信息發(fā)送給商戶，以便關(guān)聯(lián)請求的上下文（商戶需要通過openid來給相應(yīng)用戶下單），商戶需要接收處理該消息，并返回應(yīng)答。

對后臺通知交互時，如果微信收到商戶的應(yīng)答不符合規(guī)范或超時，微信認(rèn)為通知失敗，微信會通過一定的策略定期重新發(fā)起通知，盡可能提高通知的成功率，但微信不保證通知最終能成功。（通知頻率為0s/15s/15s/30s/180s/1800s/1800s/1800s/1800s/3600s）3600s后為周期進(jìn)行重試（3600S為一個周期），重試超過3天后不再通知。

通知報文

服務(wù)開啟/解除授權(quán)結(jié)果通知是以POST方法訪問商戶設(shè)置的通知url，通知的數(shù)據(jù)以JSON格式通過請求主體（BODY）傳輸。通知的數(shù)據(jù)包括了加密的授權(quán)/解除授權(quán)結(jié)果詳情。
（注：由于涉及到回調(diào)加密和解密，商戶必須先設(shè)置好apiv3密鑰后才能解密回調(diào)通知，apiv3密鑰設(shè)置文檔指引詳見APIv3密鑰設(shè)置指引）

參數(shù)解密

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

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

注： AEAD_AES_256_GCM算法的接口細(xì)節(jié)，請參考rfc5116。微信支付使用的密鑰apiv3 key長度為32個字節(jié)，隨機(jī)串nonce長度12個字節(jié)，associated_data長度小于16個字節(jié)并可能為空。

通知參數(shù)

通知簽名

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

回調(diào)示例

授權(quán)結(jié)果通知

{
    "id":"EV-2018022511223320873",
    "create_time":"2019-07-30T16:36:59+08:00",
    "resource_type":"encrypt-resource",
    "event_type":"PAYSCORE.USER_OPEN_SERVICE",
    "resource" : {
        "algorithm":"AEAD_AES_256_GCM",
        "ciphertext": "...",
        "nonce": "...",
        "associated_data": "",
    },
	"summary": "授權(quán)成功"
}

商戶對resource對象進(jìn)行解密后，得到的資源對象示例

{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "out_request_no": "1234323JKHDFE1243252",
  "service_id": "500001",
  "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "user_service_status":"USER_OPEN_SERVICE",
  "openorclose_time":"20180225112233",
  "authorization_code":"1275342195190894594"
}

解除授權(quán)結(jié)果通知

{
   "id":"EV-2018022511223320873",
   "create_time":"2019-07-30T16:36:59+08:00",
   "resource_type":"encrypt-resource",
   "event_type":"PAYSCORE.USER_CLOSE_SERVICE",
   "resource" : {
       "algorithm":"AEAD_AES_256_GCM",
       "ciphertext": "...",
       "nonce": "...",
       "associated_data": "",
  }
}

商戶對resource對象進(jìn)行解密后，得到的資源對象示例

{
 "appid": "wxd678efh567hg6787",
 "mchid": "1230000109",
 "service_id": "500001",
 "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
 "user_service_status":"USER_CLOSE_SERVICE",
 "openorclose_time":"20180225112233",
 "authorization_code":"1275342195190894594",
 "out_request_no":"1234323JKHDFE1243252"
}

開啟/解除授權(quán)成功通知參數(shù)

通知應(yīng)答

接收成功：HTTP應(yīng)答狀態(tài)碼需返回200或204，無需返回應(yīng)答報文。

接收失敗：HTTP應(yīng)答狀態(tài)碼需返回5XX或4XX，同時需返回應(yīng)答報文，格式如下：

{  
    "code": "FAIL",
    "message": "失敗"
}