支付宝小程序：获取会员收货地址

产品介绍简介

收货地址填写，对于用户来说是复杂繁琐的操作，常因为收货地址填写耗时长而导致用户流失。

为提升用户体验，让商户/开发者的服务流程更加顺畅，支付宝开放平台在充分告知用户、并得到用户授权的情况下，允许商户/开发者获取用户指定的收货地址信息。

开发者可以引导用户在支付宝收货地址列表页面，选择具体收货地址。并在用户授权的情况下，获取用户所选择的收货地址，用以进一步开展业务。

注意：为了保证用户良好的授权体验，请开发者和商家在业务真实需要时发起授权请求，不要在小程序的首屏就唤起授权。如果用户没有在支付宝维护收货地址，则会出现添加收货地址的页面供用户填写，待用户填写完成后再发起授权。

用户可根据自己的实际需求，在支付宝客户端内，选择或新增收货地址，商户可获取该收货地址详细信息，包括：姓名、联系手机、地址详情等。 用户端页面样式如下：

该能力仅对企业支付宝账户开放。

免费。

要在您的小程序内使用获取会员收货信息功能，您需要首先完成?开发者入驻?并?创建小程序。

小程序创建完成后，开发者登录开放平台控制台>找到已创建的小程序>点击进入小程序管理后台>在 版本管理 页面的能力列表部分点击添加能力 >勾选获取会员收货地址能力并点击 确定 完成能力添加。添加完成的能力状态显示为 已生效 即可使用该能力。

申请成功后，需要 1 个工作日左右的审批时间（审批结果会以短信和邮件形式告知），审批成功后，即可调用获取会员收货地址功能。

注意：

• 请确认当前登陆的账号为主账号，否则功能列表无法显示申请用户信息入口。

• 创建小程序时若未指定小程序类目需在对应小程序详情页小程序信息中补充主营行业，否则功能列表无法显示申请用户信息入口。

• 若已配置小程序类目但仍无 申请用户信息 入口，表示该类目不支持申请此用户信息。

在开发者可调用 my.getAddress 接口，在用户授权后获取其收货地址。

注意：由于开发者工具版本限制，目前 my.getAddress 接口暂不支持在开发者工具调试和真机调试，仅支持真机预览。开发者请调至 预览 模式，在支付宝客户端扫码查看效果。

// .jsrrmy.getAddress({r  success: (res) => {r    my.alert({r      title: JSON.stringify(res)r    });r  }r});r

为简化广大商户的接入流程，同时丰富第三方服务开发者（即系统服务商，下称 ISV）的代调用场景，支付宝开放平台目前支持第三方服务开发者代商户获取用户收货地址。在代商户获取收货地址前，第三方服务开发者需要选择?模板开发模式?或者?代开发模式?两种方式之一代商户开发小程序。以下分别介绍在两种模式下，第三方服务开发者代商户获取收货地址的步骤。

注意：

• ISV 代商户获取用户信息前，需为商户小程序添加小程序经营类目（否则不会展示 申请用户信息 入口）。

• 若已配置小程序类目但仍无 申请用户信息 入口，表示该类目不支持申请此用户信息。

1. 按照模板开发模式?指引，创建小程序模板和第三方应用，并将创建完成的小程序模板授权给第三方应用；

2. 在第三方应用管理中心的“功能管理”页面中，添加添加?获取会员收货地址；

3. ISV 开发小程序模板：在小程序开发工具（IDE）内完成小程序模板的前端代码开发，按照 my.getAddress 接口文档中的指引完成相关代码开发；

4. 完成前后端的开发后，ISV 即可上传并提审模板，将开发好的小程序模板发布至服务市场，详情可以参考?发布至服务市场?步骤；

5. 商户完成 订购模板 并实例化小程序后，ISV 按照下图指引，在第三方应用的管理中心替代商户提交相关材料（如使用场景、使用流程和 demo 等），ISV 可以通过自有渠道或系统在商户订购时向商户收集这些资料；ISV 也可以引导商户在商户的小程序管理中心添加获取会员收货地址功能并申请用户信息（见上文?申请用户信息）；

6. 在用户信息申请审批通过后（约为一个工作日），ISV 进行后续功能的开发和帮助商户 实施小程序。

注意：

由于在第三方应用的功能列表新增一个功能后，已授权的商户小程序无法调用最新添加的功能包内的接口；故上图中 ISV 的授权应用列表中只会出现最新授权状态下的小程序。如果 ISV 在列表中没有找到商户的小程序，可以重新发起一次授权。

1. 商户在 ISV?引导下或者商户自主创建小程序，并添加 ISV 的开发人员为小程序开发者，详情参见?详细步骤；

2. ISV 创建第三方应用，并在第三方应用的“功能管理”页面添加获取会员收货地址；

3. 申请信息：ISV 按照上图指引，在第三方应用的管理中心替代商户提交相关材料（如使用场景、使用流程和 demo 等，ISV 可以事先通过自有渠道或系统向商户收集这些资料），申请用户信息；ISV 也可以引导商户在商户的小程序管理中心添加获取会员收货地址功能并申请用户信息（见上文接入指引>第三步：申请信息）；

4. 在用户信息申请审批通过后（约为一个工作日），ISV 发起授权，商户同意后将小程序授权给 ISV 的第三方应用，详见?授权步骤指引；

5. ISV 帮助商户在小程序开发工具（IDE）内完成获取会员收货地址功能开发。