接口說(shuō)明

適用對(duì)象：直連商戶 服務(wù)商

請(qǐng)求URL：由商圈側(cè)提供接口鏈接地址，必須為https協(xié)議。如果鏈接無(wú)法訪問(wèn)，商戶將無(wú)法接收到微信通知。 通知url必須為直接可訪問(wèn)的url，不能攜帶參數(shù)。示例： “http://www.tg885.com/wxpay/pay.action”

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

通知規(guī)則

授權(quán)顧客在商圈內(nèi)門(mén)店支付完成后再退款，微信會(huì)把相關(guān)退款通知發(fā)送給商圈商戶，商戶需要接收處理，并返回應(yīng)答。出于安全的考慮，我們對(duì)通知數(shù)據(jù)進(jìn)行了加密，商戶需要先對(duì)通知數(shù)據(jù)進(jìn)行解密，才能得到退款通知數(shù)據(jù)。

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

通知報(bào)文

退款結(jié)果通知是以POST方法訪問(wèn)商戶設(shè)置的通知url，通知的數(shù)據(jù)以JSON格式通過(guò)請(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)求來(lái)自微信。微信會(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)證》。

回調(diào)示例

退款結(jié)果通知

{
  "id": "608888fa-d775-51bf-a003-e69999999943",
  "create_time": "2020-07-17T19:34:36+08:00",
  "resource_type": "encrypt-resource",
  "event_type": "MALL_REFUND.SUCCESS",
  "summary": "退款成功",
  "resource": {
    "original_type": "mall_refund",
    "algorithm": "AEAD_AES_256_GCM",
    "ciphertext": "HKclSVKXUpTlcv5BtKJmJUB6bXGgewG2dxLBHT9Ug17P/q3zSCIpSDQb6toxMKHpA7szV7aec7cwVVXTojkHl6pppX4O4CIvwtyJvUy2HL5q/vsSKtuD6Xf77yl4nU5G/53UBDxsFvnxqhQ3yYOrAH7YJxm5bh1mi0rBWJ5K3YzTiSgNvOk/Mw5DK88XVFKlBVnmcvTzcQFrNf6DVRj92JZGftn8bimY75zPePZ/LOyQx5Nflr02Vxa3BBn5Y7d5Lh35T8kAssbBjh70jcfZI+VWjP1FymW+apyDQUYocT7T17RaUTVY14A+vI3GLEJbu2Z9DqDF3V04vRc0vNZfCqwXL3J82SnpI7YG9KTGrUynINWNXck5M17EvgEjIRiSsNtxlh75eSLptDvC5dVuexlc+Prf4IKsXmMIPlQRHfnxeCRvTPBOkh6m9YGrisaHHjmg8+wJ6NC5+Q4X1zNd07Q/0/x9",
    "associated_data": "mall_refund",
    "nonce": "gHGhrVwsadasdrT"
  }
}

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

{
  "mchid": "1234567890",
  "merchant_name": "萬(wàn)象天地",
  "shop_name": "重慶烤魚(yú)（萬(wàn)象天地店）",
  "shop_number": "50001",
  "openid": "swe23be954ffots3jrvjweslfmde",
  "appid": "wx2c23be954ff1624f",
  "refund_time": "2018-05-23T12:13:50+08:00",
  "pay_amount": 100,
  "refund_amount":100,
  "transaction_id": "42000001217201407033233368018",
  "refund_id": "1217752501201407033233368999"
}

退款結(jié)果通知參數(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": "ERROR_NAME",
  "message": "ERROR_DESCRIPTION",
}