接口调用许可

企业微信通过向服务商开放接口，实现企业微信与服务商产品之间的相互调用，一起满足企业在各应用场景下的使用需求。为了确保服务商正确与规范的使用接口，企业微信向服务商颁发接口调用许可。

服务商在获得调用许可并在企业管理员授权后，可将账号激活码绑定到企业成员，以激活基于该成员调用企业微信接口的能力。

开通接口调用许可时，服务商向企业微信支付许可费用，同时取消现有的按照收款资金固定比例收取的“技术服务费”。

接口调用许可账号

许可账号，也即接口调用许可账号，按照能力的不同，分为两种类型：基础账号与互通账号。
服务商为企业提供服务时，至少需要为企业成员开通基础账号，才能为该成员调用身份验证、应用发消息等接口。
服务商为企业提供微信客户联系相关的功能时，需要为企业成员开通互通账号。开通了互通账号，自动拥有了基础账号的能力。
下文中，如无特殊说明，接口调用许可账号将简称为许可账号，或者账号。

接入指引

企业微信服务商管理端提供了下单、支付、绑定激活、退款等功能。为了提高服务商的工作效率，企业微信提供了以下接口，以让服务商可以更加自动化地处理账号激活等事务，从而让企业获得更好的使用体验。

一、下单购买账号
服务商下单为企业购买新的账号，可以同时购买基础账号与互通账号。下单之后，需要到服务商管理端发起支付，支付完成之后，订单才能生效。查看接口详情

二、下单续期账号
可以下单为一批已激活账号的成员续期。同样，下单之后，需要到服务商管理端发起支付，支付完成之后，订单才能生效。查看接口详情

三、获取订单详情
由于目前需要在服务商管理端手动发起支付，故服务商的系统有必要在某个时机查询订单的状态，当订单已支付完成，则可再调用获取订单中的账号列表接口，以获取账号激活码列表。查看接口详情

四、获取订单中的账号列表
查询指定订单下的接口许可账号列表。若为购买账号的订单，则返回账号激活码列表；若为续期账号的订单，则返回续期账号的成员列表。注意，若是购买账号的订单，则仅订单支付完成时，企业微信系统才会生成账号，故支付完成之前，该接口不会返回账号激活码。
当订单为购买账号的订单时，该接口尤其重要，因为获取到账号激活码列表之后，服务商后续可以自动地为企业的成员绑定激活相应的服务能力。
查看接口详情

五、激活账号
将账号激活码绑定到某个企业员工上，以对其激活相应的服务能力。查看接口详情

六、账号继承
在企业员工离职或者工作范围的有变更时，允许将其许可账号继承给其他员工。查看接口详情

七、其他接口
除了以上六个关键的接口，企业微信还提供了获取订单列表、获取激活码详情、获取企业的账号列表、获取成员的激活详情等接口，以让服务商可以在自己的系统中实现完整的接口调用许可管理。

许可账号失效的表现

如果服务商没有为企业成员开通接口许可，或者已开通的接口许可过期，原则上将无法为该企业成员调用企业微信的接口，服务商需要及时开通或续期接口许可。目前明确有影响的接口包括但不限于以下列表。

基础账号失效的接口表现

基础账号失效包括两种情况：1. 未配置基础账号，2. 基础账号已过期。
特别地，若配置了有效的互通账号，则自动拥有了基础账号。

互通账号失效的接口表现

互通账号失效包括两种情况：1. 未配置互通账号，2. 互通账号已过期。

测试指引

由于企业授权安装服务商的应用之后，会有90天的免费试用期，服务商难以测试到接口不可调用的表现，企业微信发布了测试企业的功能，服务商可在 服务商管理端-应用管理-开发配置 或者 服务商助手-工具-通用配置-开发配置 配置测试企业。配置为测试的企业，有以下特点：

1. 为测试企业购买的订单支付金额为0元，即服务商无须支付费用。
2. 安装的应用将立即不可调用接口，也即没有免费试用期，应用类型包括第三方应用和代开发应用。
3. 为测试企业购买时长和续期时长最长一个月。
4. 测试企业安装的应用将在安装90天后自动删除。
5. 服务商最多可以配置30个测试企业。
6. 将企业从测试企业列表中移除后，企业中该服务商的所有测试授权应用会同步删除。

通过测试企业，服务商可以方便地调试到有许可账号和无许可账号的不同表现。

FAQ

1. 自建应用代开发也需要接入接口调用许可吗？
   答：需要的。代开发应用与第三方应用都需要接入。
   
   
2. 应用安装之后，如果未购买接口许可，企业成员就立即不可使用吗？
   答：每个应用授权安装之后，有90天的免费试用期，试用期内即使未购买接口许可，也可正常使用。需要注意的是：免费试用期从该应用的首次安装开始计起，将应用删除重装，试用期不变。
   
   
3. 为测试企业通过接口下单之后，还需要到服务商管理端支付吗？
   答：不需要，为测试企业下的订单都是0元免支付单，下单后立即为“已支付”状态。
   
   
4. 账号继承时，转移成员与接收成员必须是在第三方应用的可见范围之内吗？
   答：不需要是在第三方应用的可见范围。
   
   
5. 账号继承时，如果接收成员已经有相同类型的许可账号了，能成功继承吗？
   答：不能，接口返回错误码701018。
   
   
6. 账号的有效期从什么时候开始计起？什么时候结束？
   答：账号有效期从激活时计起，到账号时长之后的结束日第二天0点结束。账号时长每个月按31天计算，每年按12*31共372天计算。举个例子：购买的账号是1年，在2022年5月17号 12:30激活，那该账号从激活时开始生效，372天之后是2023年5月24号 12:30，实际失效是在5月25号0点失效。
   
   
7. 企业安装了服务商的多个应用，需要为同一个成员购买多个接口调用许可吗？
   答：不需要，无论安装多少个应用，一个成员都只需要购买一个接口调用许可。
   
   
8. 何时应该为一个企业成员激活账号？
   答：企业授权安装应用之后，或者将新的成员加入到应用可见范围之内，企业微信会为每个成员回调成员关注事件，此时服务商先在本地存储查询该成员是否有开通许可，如未开通，即可调用激活账号接口进行激活。
   
   
9. 代开发应用拿到的corpid跟userid如果是明文的，如何将明文的corpid跟userid转换成密文？
   答：参考corpid转换以及userid的转换。
   注：目前相关接口的请求参数的corpid或者userid已经同时支持明文跟密文。但是接口返回的参数还是统一返回的密文。