微信支付v3開發(6) 收貨地址共享接口
請看新版教程 微信支付開發(7) 收貨地址共享接口V2
本文介紹微信支付下的收貨地址共享接口的開發過程。
一. 簡單介紹
微信收貨地址共享，是指用戶在微信瀏覽器內打開網頁，填寫過地址後，興許能夠免填寫支持高速選擇。也可添加和編輯。
此地址為用戶屬性。可在各商戶的網頁中共享使用。支持原生控件填寫地址。地址數據會傳遞到商戶。
地址共享是基於微信JavaScript API 實現。僅僅能在微信內置瀏覽器中使用，其它瀏覽器調用無效。
同一時候，須要微信5.0 版本號才幹支持，建議通過user agent 來確定用戶當前的版本號號後再調用地址接口。以iPhone 版本號為例。能夠通過useragent可獲取例如以下微信版本號演示樣例信息："Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X)AppleWebKit/534.46(KHTML,like Geocko) Mobile/9B206MicroMessenger/5.0"當中5.0 為用戶安裝的微信版本號號。商戶能夠判定版本號號是否高於或者等於5.0。
地址格式
微信地址共享使用的數據字段包含：
- 收貨人姓名
- 地區，省市區三級
- 具體地址
- 郵編
- 聯系電話
當中，地區相應是國標三級地區碼。如“廣東省-廣州市-天河區”，相應的郵編是是510630。詳情參考鏈接：http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201401/t20140116_501070.html
二. OAuth2.0授權
獲取收貨地址之前前須要調用 登錄授權接口獲取到一次OAuth2.0的Access Token 。所以須要做一次授權，這次授權是不彈出確認框的。
事實上質就是在用戶訪問
http://www.fangbei.org/wxpay/js_api_call.php
時跳轉到
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx8888888888888888&redirect_uri=http://www.fangbei.org/wxpay/js_api_call.php&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect
以此來獲得code參數，並依據code來獲得授權access_token及openid，這個access token將用於收貨地址共享接口。
事實上現的具體流程可參考 微信公眾平臺開發（71）OAuth2.0網頁授權
二、獲取隨機字符串
生成隨機字符串的方法例如以下
三、生成簽名
參與addrSign 簽名的字段包含：appId、url（調用JavaScript API的網頁url）、timestamp、noncestr、accessToken
這裏須要註意的是簽名過程中全部參數名均為小寫字符。比如appId 在排序後字符串則為appid。
對string1作簽名算法，字段名和字段值都採用原始值，不進行URL 轉義。
具體簽名算法為addrSign = SHA1(string1)。這裏給出生成addrSign 的具體示比例如以下：
appId=wx17ef1eaef46752cb url=http://open.weixin.qq.com/ timeStamp=1384841012 nonceStr=123456 accessToken=OezXcEiiBSKSxW0eoylIeBFk1b8VbNtfWALJ5g6aMgZHaqZwK4euEskSn78Qd5pLsfQtuMdgmhajVM5QDm24W8X3tJ18kz5mhmkUcI3RoLm7qGgh1cEnCHejWQo8s5L3VvsFAdawhFxUuLmgh5FRA
i：經過a過程鍵值對排序後得到string1 為：
accesstoken=OezXcEiiBSKSxW0eoylIeBFk1b8VbNtfWALJ5g6aMgZHaqZwK4euEskSn78Qd5pLsfQtuMdgmhajVM5QDm24W8X3tJ18kz5mhmkUcI3RoLm7qGgh1cEnCHejWQo8s5L3VvsFAdawhFxUuLmgh5FRA&appid=wx17ef1eaef46752cb&noncestr=123456×tamp=1384841012&url=http://open.weixin.qq.com/?code=CODE&state=STATE
ii：經過b過程簽名後可得到：
addrSign=SHA1(accesstoken=OezXcEiiBSKSxW0eoylIeBFk1b8VbNtfWALJ5g6aMgZHaqZwK4euEskSn78Qd5pLsfQtuMdgmhajVM5QDm24W8X3tJ18kz5mhmkUcI3RoLm7qGgh1cEnCHejWQo8s5L3VvsFAdawhFxUuLmg h5FRA&appid=wx17ef1eaef46752cb&noncestr=123456×tamp=1384841012&url=http://open.weixin.qq.com/?code=CODE&state=STATE)=ca604c740945587544a9cc25e58dd090f200e6fb
實現代碼例如以下
四、獲得收貨地址
編輯並獲取用戶收貨地址editAddress接口，在網頁前端調用。
參數列表：
| 參數 | 必填 | 說明 |
|---|---|---|
| appId | 是 | 公眾號appID |
| scope | 是 | 填寫“jsapi_address”，獲得編輯地址權限 |
| signType | 是 | 簽名方式，眼下僅支持SHA1 |
| addrSign | 是 | 簽名，由各參數一起參與簽名生成 |
| timeStamp | 是 | 時間戳 |
| nonceStr | 是 | 隨機字符串 |
調用方法例如以下
參數返回：
| 返回值 | 說明 |
|---|---|
| err_msg | edit_address：ok獲取編輯收貨地址成功 |
| edit_address：fail獲取編輯收貨地址失敗 | |
| username | 收貨人姓名 |
| telNumber | 收貨人電話 |
| addressPostalCode | 郵編 |
| proviceFirstStageName | 國標收貨地址第一級地址 |
| addressCitySecondStageName | 國標收貨地址第二級地址 |
| addressCountiesThirdStageName | 國標收貨地址第三級地址 |
| addressDetailInfo | 具體收貨地址信息 |
| nationalCode | 收貨地址國家碼 |
五、演示樣例
微信支付v3開發(6) 收貨地址共享接口