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

2020-09-16 15:50 更新

my.getAddress

版本要求:基础库 1.20.4 或更高版本,若版本较低,建议做 兼容处理

注意**:**

  • 由于开发者工具版本限制,目前 my.getAddress 接口暂不支持在开发者工具调试和真机调试,仅支持真机预览。开发者请调至 预览 模式,在支付宝客户端扫码查看效果。
  • 此 API 暂仅支持企业支付宝账户使用。

商户在寄送外卖、快递或其他场景需要用户填写地址信息时,可通过调用此 API 直接获取地址数据,无需用户手动填写。

调用接口时会弹出授权框,用户点击弹框按钮同意授权后,可以通过接口获取到返回的收货地址数据。若用户未授权,则无法返回正确信息。

示例代码

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

入参

Object 类型,属性如下:

属性 类型 必填 描述
success Function 接口调用成功的回调函数。
fail Function 接口调用失败的回调函数。
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)。

接口返回值

success 返回值

Object 类型,属性如下:

名称 类型 描述
address String 详细地址。
country String 国家名称。
prov String 省。
city String 市。
area String 区。
street String 街道。
fullname String 用户名。
mobilePhone String 手机号。

正常响应

// 正常响应
{
  "resultStatus": "9000",
  "result": {
    "address": "浙江省杭州市西湖区西溪路556号", // 详细地址
    "country": "中国", // 国家名称
    "prov": "浙江省", // 省
    "city": "杭州市", // 市
    "area": "西湖区", // 区
    "street": "", // 街道
    "fullname": "张三", // 名称
    "mobilePhone": "182XXXXXXX" // 手机号
  }
}
服务端接口异常响应

// 用户取消操作响应
{ 
  "result": '',
  "resultStatus": '6001'
}
// 用户拒绝授权响应
{
  "error": 4,
  "errorMessage": "无权调用该接口"
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号