支付寶小程序API 獲取會員收貨地址

2020-09-16 15:50 更新

my.getAddress

版本要求:基礎(chǔ)庫 1.20.4 或更高版本,若版本較低,建議做 兼容處理。

注意**:**

  • 由于開發(fā)者工具版本限制,目前 my.getAddress 接口暫不支持在開發(fā)者工具調(diào)試和真機(jī)調(diào)試,僅支持真機(jī)預(yù)覽。開發(fā)者請調(diào)至 預(yù)覽 模式,在支付寶客戶端掃碼查看效果。
  • 此 API 暫僅支持企業(yè)支付寶賬戶使用。

商戶在寄送外賣、快遞或其他場景需要用戶填寫地址信息時,可通過調(diào)用此 API 直接獲取地址數(shù)據(jù),無需用戶手動填寫。

調(diào)用接口時會彈出授權(quán)框,用戶點(diǎn)擊彈框按鈕同意授權(quán)后,可以通過接口獲取到返回的收貨地址數(shù)據(jù)。若用戶未授權(quán),則無法返回正確信息。

示例代碼

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

入?yún)?/h4>

Object 類型,屬性如下:

屬性 類型 必填 描述
success Function 接口調(diào)用成功的回調(diào)函數(shù)。
fail Function 接口調(diào)用失敗的回調(diào)函數(shù)。
complete Function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)。

接口返回值

success 返回值

Object 類型,屬性如下:

名稱 類型 描述
address String 詳細(xì)地址。
country String 國家名稱。
prov String 省。
city String 市。
area String 區(qū)。
street String 街道。
fullname String 用戶名。
mobilePhone String 手機(jī)號。

正常響應(yīng)

// 正常響應(yīng)
{
  "resultStatus": "9000",
  "result": {
    "address": "浙江省杭州市西湖區(qū)西溪路556號", // 詳細(xì)地址
    "country": "中國", // 國家名稱
    "prov": "浙江省", // 省
    "city": "杭州市", // 市
    "area": "西湖區(qū)", // 區(qū)
    "street": "", // 街道
    "fullname": "張三", // 名稱
    "mobilePhone": "182XXXXXXX" // 手機(jī)號
  }
}
服務(wù)端接口異常響應(yīng)

// 用戶取消操作響應(yīng)
{ 
  "result": '',
  "resultStatus": '6001'
}
// 用戶拒絕授權(quán)響應(yīng)
{
  "error": 4,
  "errorMessage": "無權(quán)調(diào)用該接口"
}
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號