目录
可以下单为一批已激活帐号的成员续期,续期下单分为两个步骤:
在同一个订单里,首次创建任务无须指定jobid,后续指定同一个jobid,表示往同一个订单任务追加续期的成员。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/license/create_renew_order_job?provider_access_token=ACCESS_TOKEN
请求包体:
{
"corpid" : "wwxxx",
"account_list":[
{
"userid":"userid1",
"type":1
}
],
"jobid":"JOBID"
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
provider_access_token | 是 | 调用接口凭证 |
corpid | 是 | 企业id,只支持加密的corpid |
account_list | 是 | 续期的帐号列表,每次最多1000个。同一个jobid最多关联1000000个基础账号跟1000000个互通账号 |
account_list.userid | 是 | 续期企业的成员userid。只支持加密的userid |
account_list.type | 是 | 续期帐号类型。1:基础帐号,2:互通帐号 |
jobid | 否 | 任务id,若不传则默认创建一个新任务。若指定第一次调用后拿到jobid,可以通过该接口将jobid关联多个userid |
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"jobid": "xxxx",
"invalid_account_list":[
{
"errcode": 1,
"errmsg": "xxx",
"userid":"userid1",
"type":1
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 错误码 |
errmsg | 错误码说明 |
jobid | 任务id,请求包中未指定jobid时,会生成一个新的jobid返回 |
invalid_account_list | 不合法的续期账号列表 |
invalid_account_list.errcode | 账号不合法相关错误码 |
invalid_account_list.errmsg | 账号不合法相关错误描述 |
创建续期任务之后,需要调用该接口,以提交订单任务。注意,提交之后,需要到服务商管理端发起支付,支付完成之后,订单才能生效。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/license/submit_order_job?provider_access_token=ACCESS_TOKEN
请求包体:
{
"jobid" : "wwxxx",
"buyer_userid":"xxxx",
"account_duration":
{
"months":2
}
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
provider_access_token | 是 | 调用接口凭证 |
jobid | 是 | 任务id |
buyer_userid | 是 | 下单人。服务商企业内成员userid。该userid必须登录过企业微信,并且企业微信已绑定微信 |
account_duration | 是 | 账号购买时长 |
account_duration.months | 是 | 购买的月数,每个月按照31天计算。最多购买36个月。(若企业为服务商测试企业,每次续期只能续期1个月) |
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"order_id": "xxxx"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 错误码 |
errmsg | 错误码说明 |
order_id | 订单号 |