更新时间：2024-10-29 10:08:40收藏订阅更新我的文档设置返回文档产品介绍简介获取会员手机号旨在帮助商家便捷获取用户凯发k8官方网娱乐官方的联系方式，在获得用户充分授权和认可且充分保护用户隐私的前提下，快速创建会员体系或开展其它业务。有关获取会员手机号产品的详细介绍，可查看 获取会员手机号。准入条件●开发者需充分尊重用户个人隐私，妥善使用手机号码的使用范围，不得随意打扰用户。若发现信息存在超出约定范围使用或者不合理使用等情况，平台有权永久收回接口权限。●为进一步规约和确认安全资质，开发者需加入 ，并严格遵守 、开放平台第三方应用安全开发指南。 收费模式免费。接入流程接入准备第一步：创建应用及模板1服务商需 创建第三方应用 并上线。2创建小程序模板。第二步：配置接口内容加密方式1登录 ，选择 第三方应用 > 详情 > 开发设置，接口内容加密方式 中点击 设置。2确认提示内容，点击 生成新密钥，即完成配置。开发模板第一步：集成能力接口1. 小程序端获取信息服务商在小程序端调用 my.getphonenumber 接口，在用户授权后获取加密的手机号信息。再将接口返回的结果通过 my.request 接口传入第三方应用的网关地址。注意：●服务商代商家获取用户手机号信息时需传入 isvappid（第三方应用 appid）。●使用 protocols 要求 版本为 1.22.0 及以上；支付宝客户端版本为 10.1.72 及以上。请使用 my.caniuse('getphonenumber.object.protocols') 进行 兼容处理。示例代码 ：2. 服务端解密服务商需在服务端解密小程序客户端端返回的手机号信息，java 解密示例如下（更多语言验签及解密示例详情可查看 接口内容加密方式）。注意：●服务端解密时，需使用商家小程序 aes 密钥。●调试小程序模板时，使用模板 aes 密钥。 示例代码 ：第二步：配置模板1服务商将小程序模板授权给第三方应用，详情可查看 将模板授权给第三方应用。2配置小程序模板的 aes 密钥，服务商需调用 alipay.open.auth.app.aes.set（授权应用 aes 密钥设置）接口，以第三方应用自调用（即不传 app_auth_token）方式为小程序模板设置 接口内容加密方式（即 aes 密钥）。示例代码如下（以 java 语言为例）。公钥方式 ：公钥证书方式 ：注意：●配置 aes 密钥场景构造 alipayclient 时，构造方法中需传入 encryptkey 和 encrypttype，encryptkey 为当前第三方应用的 aes 密钥，encrypttype 为固定值 aes。●merchant_app_id：应用的 appid，代模板设置时传入小程序模板 appid，代商家小程序设置时传入商家小程序 appid。 服务商还可调用 alipay.open.auth.app.aes.get（授权应用 aes 密钥查询接口）（不传 app_auth_token），查询已授权给第三方应用的小程序模板或小程序应用的 aes 密钥。公钥方式 ：公钥证书方式 ：第三步：为模板申请用户信息为模板申请用户信息后，模板才有权限获取会员手机号，可查看 为模板申请用户信息。注意：会员手机号信息仅支持部分行业类目及使用场景申请，其余行业及场景申请将被驳回。支持行业详情可查看 主营行业对应可申请的会员产品范围与字段说明。第四步：测试功能完成上述步骤后，服务商将小程序模板模拟作普通小程序，真机调试 获取用户手机号信息并在服务端解密。功能验证通过后即可提审，待小程序模板通过审核后，可进行下文 代商家接入 的操作。代商家接入服务商需设置商家小程序 aes 密钥、代商家申请用户信息后，再构建商家小程序版本，否则商家小程序将无法正常运行获取会员手机号产品。第一步：创建商家小程序并授权可查看 商家创建&授权小程序。第二步：配置商家小程序1调用 alipay.open.mini.category.query（小程序类目树查询）接口，查询商家小程序可用类目。2调用 alipay.open.mini.baseinfo.modify（小程序修改基础信息）接口，代商家小程序设置 mini_category_ids（前台类目即小程序主营行业类目）。说明：会员手机号信息申请仅开放给部分行业类目及场景，其余行业及场景申请将被驳回，详情可查看 用户信息申请主营行业&使用场景汇总表。商家小程序详情页效果 ：3设置商家小程序 aes 密钥，可查看上文 配置模板。第三步：代小程序申请用户信息可查看 代商家小程序申请用户信息。第四步：构建商家小程序版本调用 alipay.open.mini.version.upload（小程序基于模板上传版本）接口，通过模板构建商家小程序版本。完成构建版本后，可生成商家小程序体验版，在体验版中测试商家小程序是否能成功获取会员手机号，若不能，可查看下方 faq。若体验版正常无误，可进行 。 faqq1：一个第三方应用最多只能代多少个授权的商家应用获取手机号？a：服务商在界面申请时单次最多可代 50 个已授权的应用申请用户信息，其余无数量限制。q2：提示 isv.missing-encrypt-key 缺少加密配置的报错？a：需要调用 alipay.open.auth.app.aes.set（授权应用 aes 密钥设置）接口给小程序模板设置 aes 密钥。q3：代商家获取手机号，获取手机号时，没有传回 sign，是什么原因？a：检查小程序详情页，是否配置接口加签方式、aes 密钥、应用网关。q4：模板代申请用户手机号屡次被拒，驳回原因应用名称被释放，如何解决？a：建议提交审核时做修改。或登录 ，点击凯发k8官方网娱乐官方首页右侧浮窗在线咨询。q5：代商家申请手机号，有的商家不可以申请，什么原因？a：并不是所有小程序都可以获取用户手机号的，和小程序行业、商家风险等相关。
