【微信公众号支付】收货地址共享接口文档V1.4

微信公众号支付收货地址共享接口文档 V1.4收货地址共享接口文档 V1.41 收货地址共享简介1.1 功能简介微信收货地址共享， 是指用户在微信浏览器内打开商品 H5 网页，填写过地 址，后续支持快速选择免填写，也可增加和编辑此地址为用户属性，可在商户 网页中共享使用支持原生控件填写地址，地址数据会传递到商户后台1.2 功能支持地址共享是基于微信 JS API 实现，只能在微信内置浏览器中使用，其他浏 览器调用无效同时，需要微信 5.0 版本才能支持，建议通过 user agent 来确 定用户当前的版本号后再调用地址接口以 iPhone 版本为例，可以通过 user agent 可获取如下微信版本示例信息："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.01.3 地址格式微信地址共享使用的数据字段包括：- 收货人姓名- 地区，省市区三级- 详细地址- 邮编- 联系电话其中，地区对应是国标三级地区码，如“广东省-广州市-天河区”，对应的是510630。

详情参考： HYPERLINK"2公众号收货地址JS API接口定义2.1编辑并获取收货地址公众号编辑收货地址editAddress参数列表参数必填说明appId是公众号appIDscope是填写“ jsapi address ”，获得编辑地址权限sig nType是签名方式，目前仅支持SHA1addrSig n是签名timeStamp是时间戳non ceStr是随机字符串说明:addrSign 的生成规则如下参与addrSign签名的字段包括：appId、 url （当前网页 url ）、timestamp 、noncestr、accessToken （用户授权凭证， 请参照oauth2.0 协议获取）这里scope、signType并不参与签名对所有 待签名参数按照字段名的ASCII码从小到大排序（字典序）后，使用 URL键值对的格式（即key仁value1 &key2=value2 …）拼接成字符串string1这里需 要注意的是所有参数名均为小写字符，例如 appId 在排序后字符串则为 appid ； 对 string1 作签名算法，字段名和字段值都采用原始值，不进行 URL 转义。

具体 签名算法为 addrSign = SHA1(string1) 这里给出生成 addrSign 的具体示例如 下： 示例： appId=wx17ef1eaef46752cb url= timeStamp=1384841012 nonceStr=123456 accessToken=OezXcEiiBSKSxW0eoylIeBFk1b8VbNtfWALJ5g6aMgZHaqZ wK4euEskSn78Qd5pLsfQtuMdgmhajVM5QDm24W8X3tJ18kz5mhmkUcI 3RoLm7qGgh1cEnCHejWQo8s5L3VvsFAdawhFxUuLmgh5FRAi :经过a过程键值对排序后得到string1为： accesstoken=OezXcEiiBSKSxW0eoylIeBFk1b8VbNtfWALJ5g6aMgZHaqZ wK4euEskSn78Qd5pLsfQtuMdgmhajVM5QDm24W8X3tJ18kz5mhmkUcI 3RoLm7qGgh1cEnCHejWQo8s5L3VvsFAdawhFxUuLmgh5FRA&appId=w x17ef1eaef46752cb&noncestr=123456×tamp=1384841012&url= ii :经过b过程签名后可得到： addrSign=SHA1(accesstoken=OezXcEiiBSKSxW0eoylIeBFk1b8VbNtfWA LJ5g6aMgZHaqZwK4euEskSn78Qd5pLsfQtuMdgmhajVM5QDm24W8X3 tJ18kz5mhmkUcI3RoLm7qGgh1cEnCHejWQo8s5L3VvsFAdawhFxUuLmgh5FRA&ap pld=wx17ef1eaef46752cb&non cestr=123456×tamp=1 384841012&url=http://ope n.weixi n. c25e58dd090f200e6fb参数返回：返回值说明err_msgedit_address:ok获取编辑收货地址成功edit_address:fail获取编辑收货地址失败userName收货人姓名telNumber收货人电话addressPostalCode邮编proviceFirstStageName国标收货地址第一级地址addressCitySeco ndStageName国标收货地址第二级地址addressCou ntiesThirdStageName国标收货地址第三级地址addressDetail Info详细收货地址信息n ati on alCode收货地址国家码使用示例Weix in JSBridge.i nvoke('editAddress',{"ap pId" : getAppld(),"scope" : "jsapi_address","sig nType" : "sha1","addrSig n" : "xxxxx","timeStamp" : "12345","non ceStr" : "10000",},fun ctio n(res){//若res中所带的返回值不为空，则表示用户选择该返回值作为收货地址。

否则若返回空，则表示用户取消了这一次编辑收货地址docume nt.forml.addressl.value =res.proviceFirstStageName;docume nt.form1.address2.value =res.addressCitySeco ndStageName;docume nt.form1.address3.value =res.addressCo un tiesThirdStageName;docume nt.form1.detail.value = res.addressDetaill nfo;docume nt.form1.ph on e.value = res.telNumber;});});3基本交互流程基本交互流程如下:<3 Q."P.TWf IP . ■™w»4收货地址共享JS API申请流程简介（1）若要获取收货地址相关JS API，需要先申请具有商户支付权限的公众号;（2）在获取具有支付权限的appID后，默认已开启收货地址相关JS API权限, 但需要商家配置对应使用收货地址功能的域名，域名配置请在 公众平台网站-服 务-我的服务-OAuth2.0 网页授权中设置（针对已认证的公众号），如下图：石Hr弔戸冏①1 I iill L? [R—t'rnrrl am綻计J.'-UJBIWca.口罡艾谴氈槽恒认辻咚诂畀;EH込E：上皮硒便■^ =5 （BFS'l咅匝啖口WM2DL4-lD-29amOAjtnZO^SSfi点击修改，把授权回调页面域名设置为使用收货地址功能的域名即可微信公众号支付收货地址共享接口文档 V1.4OAuthi.OMSJgfi!微信公众号支付收货地址共享接口文档 V1.4微信公众号支付收货地址共享接口文档 V1.45报错后的调试方向（1） 签名参数必须小写（2） 调用接口参数必须用字符串格式（3） token 需要用 oauth 获取的 token，获取 token 的scope 是snsapi_base（4） 用文档验证签名算法正确性（5） 签名使用的url必须是调用时所在页面的url，此url域名要与填写Oauth2.0 授权域名一致（6）参与签名使用的url必须带上微信服务器返回的code和state参数。