第三方应用开发 服务端API 接口调用许可 订单管理 下单续期帐号
下单续期帐号

目录

  • 创建续期任务
  • 提交续期订单
  • 可以下单为一批已激活帐号的成员续期,续期下单分为两个步骤:

    1. 传入userid列表创建一个任务,创建之后,可以往同一个任务继续追加待续期的userid列表;
    2. 根据步骤1得到的jobid提交订单。

    创建续期任务

    在同一个订单里,首次创建任务无须指定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订单号
    上一篇
    下单购买帐号
    下一篇
    获取订单列表