查询某个多企业订单的详情,包括订单的状态、购买的企业、基础账号个数、互通账号个数、账号购买时长等。如需每个企业的账号列表,请使用该接口返回的 sub_order_id 调用获取订单中的账号列表接口以获取账号列表。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/license/get_union_order?provider_access_token=ACCESS_TOKEN
请求包体:
{
"order_id": "ORDERID",
"limit": 1000,
"cursor": "CURSOR"
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
provider_access_token | 是 | 应用服务商的接口调用凭证,获取方法参见服务商的凭证 |
order_id | 是 | 订单id |
limit | 否 | 返回的最大记录数,整型,最大值1000,默认值500 |
cursor | 否 | 用于分页查询的游标,字符串类型,填写上一次调用返回的 next_cursor,首次调用可不填 |
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"order":{
"order_id":"ORDERID",
"order_type":1,
"order_status":1,
"price":10000,
"create_time":150000000,
"pay_time":1550000000
},
"has_more": 1,
"next_cursor": "CURSOR",
"buy_list": [{
"sub_order_id": "SUBORDERID",
"corpid":"CORPID",
"account_count": {
"base_count":100,
"external_contact_count":100
},
"account_duration": {
"months": 2,
"days": 20
}
}]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 错误码 |
errmsg | 错误码说明 |
order | 订单详情,详见OrderInfo |
has_more | 是否有更多。 0: 没有, 1: 有 |
next_cursor | 分页游标,下次请求时填写到 cursor 以获取之后分页的记录 |
buy_list | 多企业购买信息列表,详见BuyInfo |
OrderInfo 说明
参数 | 说明 |
---|---|
order_id | 订单号 |
order_type | 订单类型 8:多企业新购订单 |
order_status | 订单状态 0:待支付 1:已支付 2:已取消(未支付,订单已关闭) 3:未支付,订单已过期 |
price | 订单金额,单位分 |
create_time | 创建时间,Unix时间戳 |
pay_time | 支付时间,Unix时间戳 |
BuyInfo 说明
参数 | 说明 |
---|---|
sub_order_id | 子订单id,可以调用获取订单中的账号列表接口以获取账号列表 |
corpid | 客户企业id,返回加密的corpid |
account_count | 订单的账号数详情 |
account_count.base_count | 基础账号个数 |
account_count.external_contact_count | 互通账号个数 |
account_duration | 账号购买时长 |
account_duration.months | 购买的月数,每个月按照31天计算 |
account_duration.days | 购买的天数 |