接口說明

適用對象：服務商

請求方式：POST

請求URL：該鏈接是通過[申請退款接口]指定的notify_url，必須為https協(xié)議。如果鏈接無法訪問，商戶將無法接收到微信通知。 通知url必須為直接可訪問的url，不能攜帶參數(shù)。示例： “http://www.tg885.com/wxpay/pay.action”

通知規(guī)則

商戶退款完成后，微信會把相關退款結果和用戶信息發(fā)送給清算機構，清算機構需要接收處理后返回應答成功，然后繼續(xù)給異步通知到下游從業(yè)機構。

對后臺通知交互時，如果微信收到應答不是成功或超時，微信認為通知失敗，微信會通過一定的策略定期重新發(fā)起通知，盡可能提高通知的成功率，但微信不保證通知最終能成功。（通知頻率為15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 總計 24h4m）

通知報文

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

參數(shù)解密

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

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

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

通知參數(shù)

通知簽名

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

回調(diào)示例

退款通知

{
    "id":"EV-2018022511223320873",
    "create_time":"2018-06-08T10:34:56+08:00",
    "resource_type":"encrypt-resource",
    "event_type":"REFUND.SUCCESS",
    "summary":"退款成功",
    "resource" : {
        "original_type": "refund",
        "algorithm":"AEAD_AES_256_GCM",
        "ciphertext": "...",
        "associated_data": "",
        "nonce": "..."
    }
}

商戶對resource對象進行解密后，得到的資源對象示例

{
    "sp_mchid": "1900000100",
    "sub_mchid": "1900000109",
    "transaction_id": "1008450740201411110005820873",
    "out_trade_no": "20150806125346",
    "refund_id": "50200207182018070300011301001",
    "out_refund_no": "7752501201407033233368018",
    "refund_status": "SUCCESS",
    "success_time": "2018-06-08T10:34:56+08:00",
    "user_received_account": "招商銀行信用卡0403",
    "amount" : {
        "total": 999,
        "refund": 999,
        "payer_total": 999,
        "payer_refund": 999
    }
}

通知參數(shù)

通知應答

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

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

注意：重試過多會導致微信支付端積壓過多通知而堵塞，影響其他正常通知。

{   
    "code": "SUCCESS"
}