接口說(shuō)明

適用對(duì)象：電商平臺(tái) 服務(wù)商 直連商戶(hù)

請(qǐng)求URL：該鏈接是通過(guò)[合單下單-APP支付]、[合單下單-JS支付]提交notify_url參數(shù)設(shè)置，必須為https協(xié)議。如果鏈接無(wú)法訪(fǎng)問(wèn)，商戶(hù)將無(wú)法接收到微信通知。 通知url必須為直接可訪(fǎng)問(wèn)的url，不能攜帶參數(shù)。示例： “http://www.tg885.com/wxpay/pay.action”

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

通知規(guī)則

用戶(hù)支付完成后，微信會(huì)把相關(guān)支付結(jié)果和用戶(hù)信息發(fā)送給商戶(hù)，商戶(hù)需要接收處理該消息，并返回應(yīng)答。

對(duì)后臺(tái)通知交互時(shí)，如果微信收到商戶(hù)的應(yīng)答不符合規(guī)范或超時(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 方法訪(fǎng)問(wèn)商戶(hù)設(shè)置的通知url，通知的數(shù)據(jù)以JSON 格式通過(guò)請(qǐng)求主體（BODY）傳輸。通知的數(shù)據(jù)包括了加密的支付結(jié)果詳情。

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

1. 1、用商戶(hù)平臺(tái)上設(shè)置的APIv3密鑰【微信商戶(hù)平臺(tái)—>賬戶(hù)設(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ā)送給商戶(hù)的通知進(jìn)行簽名，并將簽名值放在通知的HTTP頭Wechatpay-Signature。商戶(hù)應(yīng)當(dāng)驗(yàn)證簽名，以確認(rèn)請(qǐng)求來(lái)自微信，而不是其他的第三方。簽名驗(yàn)證的算法請(qǐng)參考 《微信支付API v3簽名驗(yàn)證》。

回調(diào)示例

支付成功結(jié)果通知

{
    "id":"EV-2018022511223320873",
    "create_time":"20180225112233",
    "resource_type":"encrypt-resource",
    "event_type":"TRANSACTION.SUCCESS",
    "resource" : {
        "algorithm":"AEAD_AES_256_GCM",
        "ciphertext": "...",
        "nonce": "...",
        "associated_data": ""
    }
}

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

{
 "combine_appid": "wxd678efh567hg6787",
"combine_out_trade_no": "20150806125346",
 "combine_mchid": "1900000109",
 "scene_info": {
   "device_id": "POS1:1"
 },
 "sub_orders": [
   {
     "mchid": "1900000109",
     "trade_type": "JSAPI",
     "trade_state": "SUCCESS",
     "bank_type": "CMC",
     "attach": "深圳分店",
     "amount": {
       "total_amount": 10,
       "currency": "CNY",
       "payer_amount": 10,
       "payer_currency": "CNY"
     },
     "success_time": "2015-05-20T13:29:35.120+08:00",
     "transaction_id": "1009660380201506130728806387",
     "out_trade_no": "20150806125346",
     "sub_mchid": "1900000109"
   }
 ],
 "combine_payer_info": {
   "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
 }
}

支付成功通知參數(shù)

通知應(yīng)答

支付通知http應(yīng)答碼為200或204才會(huì)當(dāng)作正常接收，當(dāng)回調(diào)處理異常時(shí)，應(yīng)答的HTTP狀態(tài)碼應(yīng)為500，或者4xx。

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

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