# 查询订单详情
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
getOrder
# 功能描述
- 服务商采购商品后,可通过本接口查询购买的订单详情。
# 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxa/charge/service-provider/order/get?access_token=ACCESS_TOKEN
# 请求参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。access_token可通过getAccessToken接口获得。 |
| orderId | string | 是 | 服务商订单ID,如"DD2981741311549200000" |
# 返回参数
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| order | object Order | 订单数据 |
# Order
| 属性 | 类型 | 说明 |
|---|---|---|
| orderId | string | 订单ID |
| status | number | 订单状态,取值含义见OrderStatus |
| createTime | number | 订单创建时间戳(单位:毫秒) |
| updateTime | number | 订单更新时间戳(单位:毫秒) |
| orderPrice | string | 订单价格(单位:分,64位数字) |
| payInfo | object | 支付相关数据 |
| payInfo.applyPayTime | number | 支付下单时间戳(单位:秒) |
| payInfo.finishPayTime | number | 支付完成时间戳(单位:秒),未支付成功不返回该字段 |
| orderProductInfo | object | 订单购买的商品信息,定义见OrderProductInfo |
| invoiceInfo | object | 发票相关数据,未申请发票不返回该字段 |
| invoiceInfo.invoiceApplyTime | number | 发票申请时间戳(单位:秒) |
| invoiceInfo.invoiceStatus | number | 发票申请状态,取值含义见InvoiceStatus |
| usage | object | 订单购买资源包的用量情况,未支付成功不返回该字段 |
| usage.used | string | 已使用(64位数字) |
| usage.all | string | 总量(64位数字) |
# OrderProductInfo
| 属性 | 类型 | 说明 |
|---|---|---|
| spSpuId | string | 服务商采购的批发商品SPU ID |
| spSkuId | string | 服务商采购的批发商品SKU ID |
| spBizId | number | 服务商采购的批发商品业务ID |
| spuName | string | 商品SPU名称 |
| skuName | string | 商品SKU名称 |
| skuCnt | number | 购买SKU个数 |
| validityBeginTime | number | 资源包有效期开始时间戳(单位:秒) |
| validityEndTime | number | 资源包有效期截止时间戳(单位:秒) |
# OrderStatus
订单状态的枚举值
| 值 | 说明 |
|---|---|
| 1 | 待支付 |
| 2 | 支付成功 |
| 3 | 订单超时 |
| 5 | 退款中 |
| 6 | 退款成功 |
| 7 | 退款失败 |
| 9 | 订单取消 |
# InvoiceStatus
发票状态的枚举值
| 值 | 说明 |
|---|---|
| 1 | 开票中 |
| 2 | 已开票 |
| 3 | 开票取消 |
| 4 | 开票失败 |
# 调用示例
示例说明: HTTPS调用
# 请求数据示例
GET https://api.weixin.qq.com/wxa/charge/service-provider/order/get?access_token=ACCESS_TOKEN&orderId=DD2981741311549200000
# 返回数据示例
{
"errcode": 0,
"order": {
"orderId": "DD2981741311549200000",
"status": 2,
"createTime": 1687265841964,
"updateTime": 1687267671475,
"orderPrice": "1",
"payInfo": {
"applyPayTime": 1687265845,
"finishPayTime": 1687265856
},
"orderProductInfo": {
"spSpuId": "10000111",
"spSkuId": "20000176",
"skuCnt": 1,
"spBizId": 100100,
"spuName": "spu name",
"skuName": "sku name",
"validityBeginTime": 1687265856,
"validityEndTime": 1718801856
},
"invoiceInfo": {
"invoiceStatus": 2,
"invoiceApplyTime": 1687265870
},
"usage": {
"used": "0",
"all": "1000"
}
}
}
# 错误码
| 错误码 | 错误码取值 | 解决方案 |
|---|---|---|
| 10120002 | 参数错误 | 检查参数 |
| 10120405 | 方法不可用 | 对照文档使用正确的方法请求 |