auth_code
即用戶端付款碼的內(nèi)容。微信支付用戶端付款碼由18位數(shù)字組成,10-14開頭的為中國(guó)大陸用戶,支持使用跨境支付,15開頭的中國(guó)香港用戶,當(dāng)前僅可在中國(guó)香港及中國(guó)大陸地區(qū)使用。
單個(gè)付款碼的有效期為1分鐘,過期后付款碼會(huì)自動(dòng)刷新,使用后也會(huì)自動(dòng)失效。
離線狀態(tài)下,微信客戶端會(huì)緩存15個(gè)付款碼供用戶在網(wǎng)路情況不佳的情況下使用。但該情況僅適用于非驗(yàn)密場(chǎng)景。
openid
Openid是一個(gè)微信號(hào)在某個(gè)appid下的唯一標(biāo)識(shí),該ID是一個(gè)用戶的加密識(shí)別字符串。不同微信號(hào)在同一個(gè)appid下的openid是不同的,同一個(gè)微信號(hào)在不同appid下的openid也是不同的。
機(jī)構(gòu)可使用該參數(shù)來標(biāo)識(shí)用戶身份,確認(rèn)不同訂單的用戶是否為同一個(gè)人。同時(shí)商戶亦可將用戶openid與自有賬號(hào)體系進(jìn)行綁定,以便用戶信息的觸達(dá)。
該參數(shù)在公眾號(hào)支付及小程序支付場(chǎng)景下為必傳參數(shù)。
notify_url
機(jī)構(gòu)在調(diào)用統(tǒng)一下單接口時(shí),需要傳入回調(diào)通知地址notify_url參數(shù),以在支付完成后接收支付回調(diào)通知。
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ù)。
常見錯(cuò)誤舉例:
錯(cuò)誤描述 |
示例 |
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 |