查询礼物订单列表 | 微信开放文档

# 查询礼物订单列表

通过该接口查询小店授权送礼订单列表。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/order/presentorderlist/get?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
shop_appid	string	是	小店appid
openid	string	否	用户openid
create_time_range	TimeRange	否	订单创建时间范围
update_time_range	TimeRange	否	订单更新时间范围
page_size	number	是	订单数量(1~100)
next_key	string	否	分页参数，上一页请求返回，首次置空即可

# 请求参数示例

{
    "shop_appid": "wxxxxxxxxxxxxxxxxx",
    "open_id": "OPENID",
    "create_time_range":{
        "start_time": "1749007175",
        "end_time": "1749008175"
    },
    "page_size": 10,
    "next_key": "THE_NEXT_KEY"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
present_order_list.present_order_id	string	礼物单id
present_order_list.order_id	array	订单id列表
present_order_list	array	礼物单列表

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "present_order_list": {
        "present_order_id": "4226341196275658752",
        "order_id":["3805363027490897920", "3805363027490897924"]
    }
}

# 结构体说明

# TimeRange

时间范围结构体：

参数	类型	描述
start_time	string	开始时间
end_time	string	结束时间