# 手機號快速驗證組件

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

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

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

請注意：

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

# 收費說明

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

購買操作指引

常見問題解答

請注意：

1. 體驗額度：每個小程序賬號將有1000次體驗額度，用于開發(fā)、調(diào)試和體驗。該1000次的體驗額度為正式版、體驗版和開發(fā)版小程序共用，超額后，體驗版和開發(fā)版小程序調(diào)用同正式版小程序一樣，均收費；
2. 資源包有效期：在2023年8月28日前購買的訂單，資源包將于2023年8月28日生效；在2023年8月28日后購買的訂單，資源包將于支付成功后即刻生效；各資源包將按購買時所選擇的有效期，計算相應的到期失效時間；
3. 資源使用順序：默認先從體驗額度中劃扣，劃扣完畢后再從付費資源包中劃扣；若有多個付費資源包，將按資源包到期時間順序，先從最近到期的資源包開始劃扣，如此類推；
4. 退款規(guī)則：若購買有誤，且未正式開始使用資源包前，可以在支付成功后的7天內(nèi)申請退款?？铐棇⒃?-5個工作日內(nèi)從原支付路徑返回；若資源包已經(jīng)開始使用（使用1次及以上），則不能申請退款；若支付成功后超過7天，未發(fā)起退款申請，亦不能再申請退款。
5. 異常排查：若對調(diào)用量有疑問，可參考《手機號計費誤差問題排查指南》進行排查。

# 免費規(guī)則

符合以下情況之一的小程序，使用此能力不收費，具體如下：

1. 賬號微信認證主體類型為政府、非營利組織的小程序；
2. 賬號微信認證主體類型為事業(yè)單位，且類目為政務民生的小程序;
3. 賬號類目為公立醫(yī)療機構(gòu)、學歷教育（學校）的小程序

開發(fā)者可通過以下兩種方式查詢小程序的微信認證主體類型：

1. 進入「微信公眾平臺->點擊小程序信息->查看基本信息->微信認證主體類型」
2. 進入「微信公眾平臺->點擊右上角賬號頭像->可查看基本信息->微信認證主體類型」

# 集采模式

旨在提供更高效的落地工具，支持批量采購資源包后，可以靈活地分配給多個小程序使用。集采模式接入指引。

# 查詢和扣費節(jié)點說明

• 查詢節(jié)點：用戶點擊button時，進行資源包額度查詢。若查詢額度不足，開發(fā)者將收到錯誤碼 e.detail.errno===1400001 ，同時用戶側(cè)將收到平臺默認半屏提示“該功能使用次數(shù)已達當前小程序上限，暫時無法使用”。若開發(fā)者想自行兼容欠費邏輯，可將 button 組件中phone-number-no-quota-toast 的值設置為 false，此時平臺將不在用戶側(cè)進行提示；
• 扣費節(jié)點：開發(fā)者獲得 bindgetphonenumber 事件的 success 回調(diào)信息時，進行扣費。

# 使用方法

步驟1：需要將 button 組件 open-type 的值設置為 getPhoneNumber，當用戶點擊并同意之后，通過 bindgetphonenumber 事件獲取回調(diào)信息；

步驟2：將 bindgetphonenumber 事件回調(diào)中的動態(tài)令牌code傳到開發(fā)者后臺，并在開發(fā)者后臺調(diào)用微信后臺提供的 phonenumber.getPhoneNumber 接口，消費code來換取用戶手機號。每個code有效期為5分鐘，且只能消費一次。

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

注意

從基礎(chǔ)庫2.21.2開始，對步驟2中換取手機號信息的方式進行了安全升級，上述為新方式使用指南。（舊方式目前可以繼續(xù)使用，但建議開發(fā)者使用新方式，以增強小程序安全性）另外，新方式不再需要提前調(diào)用wx.login進行登錄。

# 代碼示例

<button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber"></button>

Page({
  getPhoneNumber (e) {
    console.log(e.detail.code)  // 動態(tài)令牌
    console.log(e.detail.errMsg) // 回調(diào)信息（成功失敗都會返回）
    console.log(e.detail.errno)  // 錯誤碼（失敗時返回）
  }
})

# 返回參數(shù)說明