# 查询订单详情
接口应在服务器端调用,详细说明参见服务端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 | 方法不可用 | 对照文档使用正确的方法请求 |