查询订单明细 | 微信开放文档

# 查询订单明细

# 1. 商家搜索异常订单

# 接口说明

支持联盟开发者根据订单ID查询订单详情

# 请求地址

POST https://api.weixin.qq.com/union/shop/order/search_abnormal_order?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
allianceAppid	string	否	推客appid，多个用英文逗号隔开
startPayTime	number	否	支付开始时间
endPayTime	number	否	支付结束时间
offset	number	是	分页查询起始位置
limit	number	是	每页查询个数
sortType	number	否	1 - 支付时间升序查询，2 - 支付时间降序查询
tradeNo	string	否	微信支付交易单号，多个用英文逗号隔开

# GET 数据示例

{
  "offset": 0,
  "limit": 10
}

# 返回值

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
orderList	Array.<Object>	订单列表
total	number	总订单数

orderList 的结构

属性	类型	说明
tradeNo	string	微信支付交易单号
paidTime	number	支付时间戳，单位为s
userPaidAmount	number	用户支付金额
commissionRatio	number	佣金比例
commissionValue	number	佣金金额
promoterInfo	number	推广者信息

promoterInfo 的结构

属性	类型	说明
appId	string	推客appid
nickName	string	推客昵称

# 返回数据示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 1,
    "orderList": [
        {
            "tradeNo": "4200001207202107293516815088",
            "paidTime": "1627564957",
            "userPaidAmount": "4",
            "commissionValue": "0",
            "commissionRatio": "500",
            "promoterInfo": {
                "appId": "wx15bb3d79890d5098",
                "nickName": "哎哟喂"
            }
        }
    ]
}

# 2. 商家搜索正常订单

# 接口说明

查询、筛选订单列表

# 请求地址

GET https://api.weixin.qq.com/union/shop/order/search_normal_order?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
offset	number	是	分页查询起始位置
limit	number	是	每页查询个数
query	string	否	关键词
allianceAppid	string	否	推客appid
orderId	number	否	交易组件订单号
outOrderId	string	否	商家自定义订单号
tradeNo	string	否	微信支付交易单号
startPayTime	number	否	支付开始时间
endPayTime	number	否	支付结束时间
commissionStatus	string	否	分佣状态，多个用英文逗号隔开，参考枚举值commissionStatusEnum
outOrderIdList	string	否	商家自定义订单号列表，多个用英文逗号隔开
transactionIdList	string	否	微信支付交易单号列表，多个用英文逗号隔开
startStatusUpdateTime	number	否	订单状态更新开始时间戳
endStatusUpdateTime	number	否	订单状态更新结束时间戳
startCommissionStatusUpdateTime	number	否	分佣状态更新开始时间戳
endCommissionStatusUpdateTime	number	否	分佣状态更新结束时间
sortBy	string	否	排序方式，参考枚举值sortByEnum，默认为 SORT_BY_PAY_TIME
sortOrder	string	否	排序方式，参考枚举值 sortOrderEnum，默认为 SORT_ORDER_DESC

# commissionStatusEnum 示例

属性	值	说明
COMMISSION_PAY_SUCCESS	2、5、8	待扣费
COMMISSION_PAY_CANCEL	4	取消扣费
COMMISSION_SHOP_FINISH_DEDUCTION	6	已扣费
COMMISSION_SHOP_DEDUCTION_NOT_ENOUGH_MONEY	7	余额不足

# sortByEnum 示例

属性	值	说明
SORT_BY_PAY_TIME	1	按支付时间排序
SORT_BY_STATUS_UPDATE_TIME	2	按订单状态更新时间排序
SORT_BY_COMMISSION_STATUS_UPDATE_TIME	3	按分佣状态更新时间排序

# sortOrderEnum 示例

属性	值	说明
SORT_ORDER_DESC	1	降序
SORT_ORDER_ASC	2	升序

# GET 数据示例

{
  "offset": 0,
  "limit": 10
}

# 返回值

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
orderList	Array.<Object>	订单列表
total	number	订单总数

orderList 的结构

属性	类型	说明
orderInfo	object	订单信息
productList	array	商品信息

orderInfo 的结构

属性	类型	说明
orderId	string	交易组件订单号
outOrderId	string	商家自定义订单号
transactionId	string	微信支付交易单号
payTime	string	成交时间
orderPrice	number	订单实际支付金额
freight	number	运费
discountedPrice	number	优惠金额
additionalPrice	number	附加金额
additionalRemarks	string	附加金额备注
status	number	订单状态
createTime	number	订单创建时间
updateTime	number	订单状态更新时间
path	string	订单的页面path
customizeInfo	string	自定义信息

productList 的结构

属性	类型	说明
title	string	商品名称
headImg	string	商品缩略图 url
salePrice	number	商品售价
realPrice	number	实际支付价格
productCnt	number	成交数量
productId	string	商家组件商品id
outProductId	string	商家自定义商品id
ratio	number	佣金比例
commissionValue	number	分佣金额
commissionStatus	string	佣金状态
commissionStatusUpdateTime	number	分佣状态更新时间
promoterInfo	object	推客信息
skuId	string	组件skuid
outSkuId	string	商家outskuid
skuAttr	Array.<Object>	sku的销售属性
customizeInfo	string	自定义信息

promoterInfo 的结构

属性	类型	说明
appId	string	推客appid
nickName	string	推客昵称

skuAttr 的结构

属性	类型	说明
attrKey	string	属性
attrValue	string	值

# 返回数据示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 1,
    "orderList": [
        {
            "orderInfo": {
                "orderId": "2018135006765744132",
                "outOrderId": "202108251711",
                "transactionId": "893921061043139",
                "payTime": "1629882495",
                "orderPrice": 2,
                "freight": 1,
                "discountedPrice": 0,
                "additionalPrice": 0,
                "additionalRemarks": "",
                "status": 20,
                "createTime": "1629882491",
                "path": "/pages/commercePlace/index"
            },
            "productList": [
                {
                    "title": "219 男女同款鞋（测试订单下单统一生成）",
                    "headImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SH/reserved/60e32624000cf9e50000000023e74f09000000a000004f50?imageView2/3/w/544",
                    "salePrice": "1",
                    "realPrice": 1,
                    "productCnt": "2",
                    "productId": "411626999",
                    "outProductId": "1625193245000",
                    "skuId": "350368072",
                    "outSkuId": "1625193244990",
                    "skuAttrs": [
                        {
                            "attrKey": "选择颜色",
                            "attrValue": "红蓝主机"
                        },
                        {
                            "attrKey": "选择套装",
                            "attrValue": "主机+保护套"
                        }
                    ],
                    "ratio": 5500,
                    "commissionValue": 1,
                    "commissionStatus": "COMMISSION_SHOP_FINISH_DEDUCTION",
                    "commissionStatusUpdateTime": 1629882946,
                    "promoterInfo": {
                        "appId": "wx15bb3d79890d5098",
                        "nickName": "哎哟喂"
                    }
                }
            ]
        }
    ]
}

# 3. 推客搜索异常订单

# 接口说明

查询、筛选订单列表

# 请求地址

GET https://api.weixin.qq.com/union/promoter/order/search_abnormal_order?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
startPayTime	number	否	支付开始时间
endPayTime	number	否	支付结束时间
offset	number	是	分页查询起始位置
limit	number	是	每页查询个数
sortType	number	否	1 - 支付时间升序查询，2 - 支付时间降序查询
tradeNo	string	否	微信支付交易单号，多个用英文逗号隔开

# GET 数据示例

{
  "offset": 0,
  "limit": 10
}

# 返回值

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
orderList	Array.<Object>	订单列表
total	number	总订单数

orderList 的结构

属性	类型	说明
tradeNo	string	微信支付单号
paidTime	number	支付时间戳，单位为s
userPaidAmount	number	用户付款金额
commissionValue	number	佣金金额
commissionRatio	number	佣金比例
promotionInfo	object	推广位信息
shopInfo	object	商家信息

promotionInfo 的结构

属性	类型	说明
promotionSourcePid	string	推广位id
promotionSourceName	string	推广位名称

shopInfo 的结构

属性	类型	说明
nickname	string	商家名称
appid	string	商家appid

# 返回数据示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 1,
    "orderList": [
        {
            "tradeNo": "4200001207202107293516815088",
            "paidTime": "1627564957",
            "userPaidAmount": "4",
            "commissionValue": "0",
            "commissionRatio": "500",
            "promotionInfo": {
                "promotionSourcePid": "onGdR5YYQKa7_jhUhQvlfHfFPw1g_1175311070",
                "promotionSourceName": "啊啊啊啊"
            },
            "shopInfo": {
                "nickname": "小测试",
                "appid": "wx539e0b4872f196d1"
            }
        }
    ]
}

# 4. 推客搜索正常订单

# 接口说明

查询、筛选订单列表

# 请求地址

GET https://api.weixin.qq.com/union/promoter/order/search_normal_order?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
offset	number	是	分页查询起始位置
limit	number	是	每页查询个数
query	string	否	关键词
orderId	number	否	交易组件订单号
outOrderId	string	否	商家自定义订单号
tradeNo	string	否	微信支付交易单号
startPayTime	number	否	支付开始时间
endPayTime	number	否	支付结束时间
commissionStatus	string	否	分佣状态，多个用英文逗号隔开，参考枚举值commissionStatusEnum
outOrderIdList	string	否	商家自定义订单号列表，多个用英文逗号隔开
transactionIdList	string	否	微信支付交易单号列表，多个用英文逗号隔开
startStatusUpdateTime	number	否	订单状态更新开始时间戳
endStatusUpdateTime	number	否	订单状态更新结束时间戳
startCommissionStatusUpdateTime	number	否	分佣状态更新开始时间戳
endCommissionStatusUpdateTime	number	否	分佣状态更新结束时间
sortBy	string	否	排序方式，参考枚举值sortByEnum，默认为 SORT_BY_PAY_TIME
sortOrder	string	否	排序方式，参考枚举值 sortOrderEnum，默认为 SORT_ORDER_DESC

# commissionStatusEnum 示例

属性	值	说明
COMMISSION_PAY_SUCCESS	2、5、6、8	支付成功
COMMISSION_PAY_CANCEL	4	取消扣费
COMMISSION_SHOP_DEDUCTION_NOT_ENOUGH_MONEY	7	余额不足

# sortByEnum 示例

属性	值	说明
SORT_BY_PAY_TIME	1	按支付时间排序
SORT_BY_STATUS_UPDATE_TIME	2	按订单状态更新时间排序
SORT_BY_COMMISSION_STATUS_UPDATE_TIME	3	按分佣状态更新时间排序

# sortOrderEnum 示例

属性	值	说明
SORT_ORDER_DESC	1	降序
SORT_ORDER_ASC	2	升序

# GET 数据示例

{
  "offset": 0,
  "limit": 10
}

# 返回值

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
orderList	Array.<Object>	订单列表
total	number	订单总数

orderList 的结构

属性	类型	说明
orderInfo	object	订单信息
productList	array	商品信息

orderInfo 的结构

属性	类型	说明
orderId	string	交易组件订单号
outOrderId	string	商家自定义订单号
transactionId	string	微信支付交易单号
payTime	string	成交时间
orderPrice	number	订单实际支付金额
freight	number	运费
discountedPrice	number	优惠金额
additionalPrice	number	附加金额
additionalRemarks	string	附加金额备注
status	number	订单状态
shopInfo	object	商家信息
createTime	number	订单创建时间
updateTime	number	订单状态更新时间
path	string	订单的页面path

shopInfo 的结构

属性	类型	说明
nickname	string	商家名称
appid	string	商家appid

productList 的结构

属性	类型	说明
title	string	商品名称
headImg	string	商品缩略图 url
salePrice	number	商品售价
realPrice	number	实际支付价格
productCnt	number	成交数量
productId	string	商家组件商品id
outProductId	string	商家自定义商品id
ratio	number	佣金比例
commissionValue	number	分佣金额
commissionStatus	string	佣金状态
commissionStatusUpdateTime	number	分佣状态更新时间
promotionInfo	object	推广位信息
skuId	string	组件skuid
outSkuId	string	商家outskuid
skuAttr	Array.<Object>	sku的销售属性
customizeInfo	string	自定义信息

promotionInfo 的结构

属性	类型	说明
promotionSourcePid	string	推广位id
promotionSourceName	string	推广位昵称

skuAttr 的结构

属性	类型	说明
attrKey	string	属性
attrValue	string	值

# 返回数据示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 1,
    "orderList": [
        {
            "orderInfo": {
                "orderId": "2018135006765744132",
                "outOrderId": "202108251711",
                "transactionId": "893921061043139",
                "payTime": "1629882495",
                "orderPrice": 2,
                "freight": 1,
                "discountedPrice": 0,
                "additionalPrice": 0,
                "additionalRemarks": "",
                "status": 20,
                "shopInfo": {
                    "nickname": "医保非税小测试",
                    "appid": "wx539e0b4872f196d1"
                },
                "createTime": "1629882491",
                "path": "/pages/commercePlace/index"
            },
            "productList": [
                {
                    "title": "219 男女同款鞋（测试订单下单统一生成）",
                    "headImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SH/reserved/60e32624000cf9e50000000023e74f09000000a000004f50?imageView2/3/w/544",
                    "salePrice": "1",
                    "realPrice": 1,
                    "productCnt": "2",
                    "productId": "411626999",
                    "outProductId": "1625193245000",
                    "skuId": "350368072",
                    "outSkuId": "1625193244990",
                    "skuAttrs": [
                        {
                            "attrKey": "选择颜色",
                            "attrValue": "红蓝主机"
                        },
                        {
                            "attrKey": "选择套装",
                            "attrValue": "主机+保护套"
                        }
                    ],
                    "ratio": 5500,
                    "commissionValue": 0,
                    "commissionStatus": "COMMISSION_SHOP_FINISH_DEDUCTION",
                    "commissionStatusUpdateTime": 1629882946,
                    "promotionInfo": {
                        "promotionSourcePid": "onGdR5bhIghIqdB7HLy4af1_9Vd4_259642642",
                        "promotionSourceName": "小孩子"
                    }
                }
            ]
        }
    ]
}