接口說明

適用對(duì)象：直連商戶

請(qǐng)求URL：該鏈接是通過商戶【預(yù)受理領(lǐng)卡請(qǐng)求】中提交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ī)則

用戶領(lǐng)取優(yōu)惠卡后，微信會(huì)把用戶領(lǐng)卡信息發(fā)送給商戶，商戶需要接收處理，并返回應(yīng)答。出于安全的考慮，我們對(duì)數(shù)據(jù)進(jìn)行加密，商戶需要先對(duì)通知數(shù)據(jù)進(jìn)行解密，才能得到用戶領(lǐng)卡信息。

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

通知報(bào)文

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

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

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

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

通知參數(shù)

通知簽名

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

回調(diào)示例

用戶領(lǐng)卡結(jié)果通知

{
    "id":"EV-2018022511223320873",
    "create_time":"2015-05-20T13:29:35+08:00",
    "resource_type":"encrypt-resource",
    "event_type":"DISCOUNT_CARD.USER_ACCEPTED",
    "resource" : {
        "algorithm":"AEAD_AES_256_GCM",
        "ciphertext": "...",
        "original_type": "discount_card",
        "nonce": "...",
        "associated_data": ""
    },
   "summary":"用戶領(lǐng)卡",
}

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

{
    "card_id": "233bcbf407e87789b8e471f251774f95",
    "card_template_id": "87789b2f25177433bcbf407e8e471f95",
    "openid": "oUpF8uMuAJ2pxb1Q9zNjWeS6o",
    "out_card_code": "6e8369071cd942c0476613f9d1ce9ca3",
    "appid": "wxd678efh567hg6787",
    "mchid": "1230000109",
    "time_range": {
        "betin_time": "2020-05-20T13:29:35.120+08:00",
        "end_time": "2020-05-21T13:29:35.120+08:00"
    },
    "state": "ONGOING",
    "create_time": "2020-05-20T13:29:35.120+08:00",
    "objectives" : [ 
	  {
	  "unit" : "次",
	  "name" : "一周購(gòu)買三次商品",
	  "count" : 1,
	  "description" : "特價(jià)商品",
	  "objective_id" : "123456"
	  }, 
	  {
	  "unit" : "次",
	  "name" : "一周購(gòu)買三次商品",
	  "count" : 1,
	  "description" : "特價(jià)商品",
	  "objective_id" : "123456"
	  } 
	],
    "rewards" : [ 
	  {
	  "unit" : "個(gè)",
	  "amount" : 100,
	  "count_type" : "COUNT_LIMIT",
	  "name" : "八折優(yōu)惠",
	  "count" : 1,
	  "description" : "特價(jià)商品優(yōu)惠",
      "reward_id" : "123456",
	  }, 
	  {
	  "unit" : "個(gè)",
	  "amount" : 100,
	  "count_type" : "COUNT_LIMIT",
	  "name" : "八折優(yōu)惠",
	  "count" : 1,
	  "description" : "特價(jià)商品優(yōu)惠",
	  "reward_id" : "123456"
	  } 
	],
	"sharer_openid" : "oUpF8uMuAJ2pxb1Q9zNjWUHsd"
}

用戶領(lǐng)卡通知參數(shù)

通知應(yīng)答

商戶后臺(tái)在正確處理回調(diào)之后，需要返回200或者204的HTTP狀態(tài)碼。其他的狀態(tài)碼，微信支付均認(rèn)為通知失敗，并按照前述的策略定期發(fā)起通知。

注意：當(dāng)商戶后臺(tái)應(yīng)答失敗時(shí)，微信支付將記錄下應(yīng)答的報(bào)文，建議商戶按照以下格式返回。

{
 "code": "SUCCESS",
  "message": "成功",
}