該能力旨在幫助開發(fā)者向用戶發(fā)起手機號申請，并且必須經過用戶同意后，開發(fā)者才可獲得由平臺驗證后的手機號，進而為用戶提供相應服務。

從基礎庫 2.21.2 開始，對該能力進行了安全升級，以下是新版本組件使用指南。（舊版本組件目前可以繼續(xù)使用，但建議開發(fā)者使用新版本組件，以增強小程序安全性）另外，新版本組件不再需要提前調用wx.login進行登錄。

該能力與手機號實時驗證組件的區(qū)別為：

1. 手機號快速驗證組件，平臺會對號碼進行驗證，但不保證是實時驗證；
2. 手機號實時驗證組件，在每次請求時，平臺均會對用戶選擇的手機號進行實時驗證。

請注意：

1. 目前該接口針對非個人開發(fā)者，且完成了認證的小程序開放（不包含海外主體）；
2. 該能力使用時，用戶可選擇綁定號碼，或自主添加號碼。平臺會基于中國三大運營商提供的短信等底層能力對號碼進行驗證，但不保證是實時驗證；
3. 請開發(fā)者根據業(yè)務場景需要自行判斷并選擇是否使用，必要時可考慮增加其他安全驗證手段。
4. 開發(fā)者需合理使用，若被發(fā)現或用戶舉報開發(fā)者不合理地要求用戶提供手機號等個人信息，中斷了正常的使用流程，影響了用戶的使用體驗，微信有權依據《微信小程序平臺運營管理規(guī)范》對該小程序進行處理。常見違規(guī)事例和具體解析；

收費說明

自2023年8月26日起，手機號快速驗證組件將需要付費使用。標準單價為：每次組件調用成功，收費0.03元。更多套餐價格請見微信公眾平臺-付費管理。 購買操作指引。

請注意：

1. 體驗額度：每個小程序帳號將有1000次體驗額度，用于開發(fā)、調試和體驗。該1000次的體驗額度為正式版、體驗版和開發(fā)版小程序共用，超額后，體驗版和開發(fā)版小程序調用同正式版小程序一樣，均收費；
2. 免費規(guī)則：帳號微信認證類型為政府、非營利組織的小程序使用此能力不收費；帳號微信認證類型為事業(yè)單位，且類目為政務民生的小程序，亦不收費（微信認證指引）。

使用方法

需要將 button 組件 open-type 的值設置為 getPhoneNumber，當用戶點擊并同意之后，可以通過 bindgetphonenumber 事件回調獲取到動態(tài)令牌code，然后把code傳到開發(fā)者后臺，并在開發(fā)者后臺調用微信后臺提供的 phonenumber.getPhoneNumber 接口，消費code來換取用戶手機號。每個code有效期為5分鐘，且只能消費一次。

注：getPhoneNumber 返回的 code 與 wx.login 返回的 code 作用是不一樣的，不能混用。

代碼示例

Page({
  getPhoneNumber (e) {
    console.log(e.detail.code)
  }
})

返回參數說明