接口說明

適用對象:直連模式機構模式

請求方式：POST

請求URL: 該鏈接是通過【扣款下單】中提交的參數(shù)notify_url設置，如果鏈接無法訪問，商戶將無法接收到微信通知。必須為https協(xié)議。如果鏈接無法訪問，商戶將無法接收到微信通知。通知url必須為直接可訪問的url，不能攜帶參數(shù)。 示例：notify_url：“http://www.tg885.com/wxpay/pay.action”

接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3/wei-xin-zhi-fu-api-v3-jie-kou-gui-fan

通知規(guī)則

扣款完成后，微信會把相關支付結(jié)果及用戶信息通過數(shù)據(jù)流的形式發(fā)送給商戶，商戶需要接收處理，并按文檔規(guī)范返回應答。出于安全的考慮，我們對通知結(jié)果數(shù)據(jù)進行了加密，商戶需要先對通知數(shù)據(jù)進行解密，才能得到結(jié)果數(shù)據(jù)。

對后臺通知交互時，如果微信收到商戶的應答不是成功或超時，微信認為通知失敗，微信會通過一定的策略定期重新發(fā)起通知，盡可能提高通知的成功率，但微信不保證通知最終能成功。（通知頻率為15/15/30/180/1800/1800/1800/1800/3600，單位：秒）

通知報文

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

下面詳細描述證書解密的流程

1、從商戶平臺上獲取商戶的密鑰，記為“key”。

2、針對resource.algorithm中描述的算法（目前為AEAD_AES_256_GCM），取得對應的參數(shù)nonce和associated_data。

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é)并可能為空。

通知報文

通知簽名

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

回調(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": ""
    }
}

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

{
	"mchid": "10000100",
	"appid": "wx2421b1c4370ec43b",
	"out_trade_no": "20150806125346",
	"transaction_id": "1008450740201411110005820873",
	"attach": "支付測試",
	"trade_type": "AUTH",
	"bank_type": "CCB_DEBIT",
	"success_time": "2018-06-08T10:34:56+08:00",
	"trade_state": "SUCCESS",
	"trade_state_desc": "支付成功",
	"merchant_category_code": "1011",
	"contract_id": "Wx15463511252015071056489715",
	"payer": {
		"openid": "oUpF8uN95-Ptaags6E_roPHg7AG0"
	},
	"amount": {
		"total": 528800,
		"currency": "HKD",
		"payer_total": 518799,
		"payer_currency": "CNY",
		"exchange_rate": {
			"type": "SETTLEMENT_RATE",
			"rate": 8000000
		}
	},
	"promotion_detail": [{
		"promotion_id": "109519",
		"name": "單品惠-6",
		"scope": "SINGLE",
		"type": "DISCOUNT",
		"amount": 1,
		"currency": "HKD",
		"activity_id": "931386",
		"wechatpay_contribute_amount": 1,
		"merchant_contribute_amount": 0,
		"other_contribute_amount": 0,
		"goods_detail": [{
			"goods_id": "iphone6s_16G",
			"goods_remark": "商品備注",
			"quantity": 1,
			"price": 528800
		}]
	}]
}

{
	"sp_mchid": "10000100",
	"sp_appid": "wx2421b1c4370ec43b",
	"sub_mchid": "20000100",
	"out_trade_no": "20150806125346",
	"transaction_id": "1008450740201411110005820873",
	"attach": "支付測試",
	"trade_type": "AUTH",
	"bank_type": "CCB_DEBIT",
	"success_time": "2018-06-08T10:34:56+08:00",
	"trade_state": "SUCCESS",
	"trade_state_desc": "支付成功",
	"merchant_category_code": "1011",
	"contract_id": "Wx15463511252015071056489715",
	"payer": {
		"sp_openid": "oUpF8uN95-Ptaags6E_roPHg7AG0"
	},
	"amount": {
		"total": 528800,
		"currency": "HKD",
		"payer_total": 518799,
		"payer_currency": "CNY",
		"exchange_rate": {
			"type": "SETTLEMENT_RATE",
			"rate": 8000000
		}
	},
	"promotion_detail": [{
		"promotion_id": "109519",
		"name": "單品惠-6",
		"scope": "SINGLE",
		"type": "DISCOUNT",
		"amount": 1,
		"currency": "HKD",
		"activity_id": "931386",
		"wechatpay_contribute_amount": 1,
		"merchant_contribute_amount": 0,
		"other_contribute_amount": 0,
		"goods_detail": [{
			"goods_id": "iphone6s_16G",
			"goods_remark": "商品備注",
			"quantity": 1,
			"price": 528800
		}]
	}]
}

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

通知應答

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

注意：當商戶后臺應答失敗時，微信支付將記錄下應答的報文，建議商戶按照以下格式返回。

200
{
	"code": "SUCCESS",
	"message": "OK"
}

{
    "code": "SYSTEM_ERROR",
    "message": "系統(tǒng)失敗"
}