回調(diào)通知注意事項(xiàng)
● notify_url需要填寫商戶自己系統(tǒng)的真實(shí)地址，不能填寫接口文檔或demo上的示例地址。
● notify_url必須是以https://或http://開頭的完整全路徑地址，并且確保url中的域名和IP是外網(wǎng)可以訪問的，不能填寫localhost、127.0.0.1、192.168.x.x等本地或內(nèi)網(wǎng)IP。
● notify_url不能攜帶參數(shù)。
● 常見錯誤舉例：
| 錯誤描述 | 錯誤示例 |
|---|---|
url中只有域名，缺少具體的路徑 |
http://www.weixin.qq.com |
url不是以https://或http://開頭，缺少域名或IP |
./PayNotify.aspx |
url中填寫了本地或者內(nèi)網(wǎng)IP |
http://127.0.0.1/pay/notify.php |
填寫了不是url格式的字符串 |
xxxxxxx，1234567，test |
2、返回報(bào)文格式規(guī)范
● 返回報(bào)文必須是xml格式，字段名需與接口文檔說明的一致，報(bào)文前后和各字段標(biāo)簽中間不能包含特殊字符。
● 常見錯誤舉例：
| 錯誤描述 | 錯誤示例 |
|---|---|
返回內(nèi)容為空或者非xml格式字符串 |
ok，success，支付成功 |
返回的xml格式報(bào)文中間有其他字符 |
<xml>\n<return_code><![CDATA[SUCCESS]]></return_code> |
返回的是json格式 |
{"return_code":"SUCCESS";"return_msg":"OK"} |
返回的是整個(gè)頁面的html代碼 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml" ><head><title>支付成功通知頁面</title></head><body>success</body></html> |
3、回調(diào)處理邏輯注意事項(xiàng)
● notify_url的代碼處理邏輯不能做登錄態(tài)校驗(yàn)。
● 商戶系統(tǒng)收到支付結(jié)果通知，需要在5秒內(nèi)返回應(yīng)答報(bào)文，否則微信支付認(rèn)為通知失敗，后續(xù)會重復(fù)發(fā)送通知。
● 同樣的通知可能會多次發(fā)送給商戶系統(tǒng)，商戶系統(tǒng)必須能夠正確處理重復(fù)的通知。如果已處理過，直接給微信支付返回成功。
● 商戶側(cè)對微信支付回調(diào)IP有防火墻策略限制的，需要對以下IP段開通白名單：
上海電信出口網(wǎng)段：101.226.103.0/25
上海聯(lián)通出口網(wǎng)段：140.207.54.0/25
上海CAP出口網(wǎng)段：121.51.58.128/25
深圳電信出口網(wǎng)段：183.3.234.0/25
深圳聯(lián)通出口網(wǎng)段：58.251.80.0/25
深圳CAP出口網(wǎng)段：121.51.30.128/25
香港出口網(wǎng)段：203.205.219.128/25
退款結(jié)果通知、分賬動賬通知IP（新增）：
175.24.214.208、175.24.211.24、175.24.213.135、109.244.180.23、114.132.203.119、43.139.43.69