Query a list of gift orders | 微信开放文档

# Query a list of gift orders

Use this interface to find a list of gift-giving orders authorized by small stores.

# Dxplaination of Interface Call Request

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

# Dxplaination of request parameters

parameter	type	Is it compulsory?	describe
shop_appid	string	yes	Shop AppID
openid	string	no	User openid
create_time_range	TimeRange	no	Order creation time frame
update_time_range	TimeRange	no	Order update time frame
page_size	number	yes	Number of orders (1 - 100)
next_key	string	no	Paged parameters. The previous page request is returned and empty the first time.

# Example of request parameters

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

# Return parameter explaination

parameter	type	describe
errcode	number	Error code
errmsg	string	Error message
present_order_list.present_order_id	string	Gift Sheet ID
present_order_list.order_id	array	Order id list
present_order_list	array	List of presents

# Example of Return Parameters

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

# Structure Dxplaination

# TimeRange

Time-range structures:

parameter	type	describe
start_time	string	Start Time
end_time	string	End Time