手机号快速验证组件

该能力旨在帮助开发者向用户发起手机号申请，并且必须经过用户同意后，开发者才可获得由平台验证后的手机号，进而为用户提供相应服务。

该能力与手机号实时验证组件的区别为：

• 手机号快速验证组件，平台会对号码进行验证，但不保证是实时验证；
• 手机号实时验证组件，在每次请求时，平台均会对用户选择的手机号进行实时验证。

请注意：

• 目前该接口针对非个人开发者，且完成了认证的小程序开放（不包含海外主体）；
• 该能力使用时，用户可选择绑定号码，或自主添加号码。平台会基于中国三大运营商提供的短信等底层能力对号码进行验证，但不保证是实时验证；
• 请开发者根据业务场景需要自行判断并选择是否使用，必要时可考虑增加其他安全验证手段。
• 开发者需合理使用，若被发现或用户举报开发者不合理地要求用户提供手机号等个人信息，中断了正常的使用流程，影响了用户的使用体验，微信有权依据《微信小程序平台运营管理规范》对该小程序进行处理。常见违规事例和具体解析；

收费说明

自2023年8月26日起，手机号快速验证组件将需要付费使用。标准单价为：每次组件调用成功，收费0.03元。更多套餐价格请见微信公众平台-付费管理。购买操作指引。

请注意：

• 体验额度：每个小程序账号将有1000次体验额度，用于开发、调试和体验。该1000次的体验额度为正式版、体验版和开发版小程序共用，超额后，体验版和开发版小程序调用同正式版小程序一样，均收费；
• 资源包有效期：在2023年8月26日前购买的订单，资源包将于2023年8月26日生效；在2023年8月26日后购买的订单，资源包将于支付成功后即刻生效；各资源包将按购买时所选择的有效期，计算相应的到期失效时间；
• 资源使用顺序：默认先从体验额度中划扣，划扣完毕后再从付费资源包中划扣；若有多个付费资源包，将按资源包到期时间顺序，先从最近到期的资源包开始划扣，如此类推；
• 退款规则：若购买有误，且未正式开始使用资源包前，可以在支付成功后的7天内申请退款。款项将在3-5个工作日内从原支付路径返回；若资源包已经开始使用（使用1次及以上），则不能申请退款；若支付成功后超过7天，未发起退款申请，亦不能再申请退款。

免费规则

符合以下情况之一的小程序，使用此能力不收费，具体如下：

• 账号微信认证主体类型为政府、非营利组织的小程序；
• 账号微信认证主体类型为事业单位，且类目为政务民生的小程序；
• 账号类目为公立医疗机构、学历教育（学校）的小程序

开发者可通过以下两种方式查询小程序的微信认证主体类型：

• 进入「微信公众平台->点击小程序信息->查看基本信息->微信认证主体类型」
• 进入「微信公众平台->点击右上角账号头像->可查看基本信息->微信认证主体类型」

集采模式

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

查询和扣费节点说明

• 查询节点：用户点击button时，进行资源包额度查询。若查询额度不足，用户将无法正常拉起半屏，且开发者收到错误码e.detail.errno===1400001，注意：此时平台不会在c端给用户任何欠费提示，开发者可根据实际情况灵活地做前端引导；
• 扣费节点：开发者获得bindgetphonenumber事件的success回调信息时，进行扣费。

使用方法

步骤1：需要将button组件open-type的值设置为getPhoneNumber，当用户点击并同意之后，通过bindgetphonenumber事件获取回调信息；

步骤2：将bindgetphonenumber事件回调中的动态令牌code传到开发者后台，并在开发者后台调用微信后台提供的phonenumber.getPhoneNumber接口，消费code来换取用户手机号。每个code有效期为5分钟，且只能消费一次。

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

代码示例

<button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber"></button>
Page({
  getPhoneNumber (e) {
    console.log(e.detail.code)   // 动态令牌
    console.log(e.detail.errMsg) // 回调信息（成功失败都会返回）
    console.log(e.detail.errno)  // 错误码（失败时返回）
  }
})