查询礼物订单详情 | 微信开放文档

# 查询礼物订单详情

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

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
present_order_id	string	是	礼物单id
openid	string	否	用户openid

# 请求参数示例

{
    "present_order_id": "4226341196275658752",
    "open_id": "OPENID"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
present_order_info	PresentOrderInfo	礼物单详情

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "present_order_info": {
        "ecsgift": {
            "gifts": {
                "gift": [
                    {
                        "order_id": 4226341196275658752,
                        "wishmessage": "祝福你",
                        "giftstatus": 0
                    }
                ]
            },
            "user_type": 1
        }
    }
}

# 结构体说明

# PresentOrderInfo

参数	类型	描述
present_order_info.ecsgift	ECsGiftInfo	礼物详情信息
present_order_info.cannot_receive	number	能否收礼
present_order_info.cannot_receive_tips	string	不能收礼tips

# ECsGiftInfo

参数	类型	描述
ecsgift.gifts	GiftList	礼物列表
ecsgift.gifts.gift	array	礼物信息列表
ecsgift.gifts.gift.order_id	number	礼物单id
ecsgift.gifts.gift.giftstatus	GiftStatus	礼物状态
ecsgift.gifts.gift.expired_time	number	礼物过期时间
ecsgift.user_type	number	用户视角
ecsgift.wishmessage	string	祝福语

# GiftStatus（礼物状态枚举）

枚举值	描述
0	待领取
1	已领取
2	已超时
3	已领取待填地址
4	礼物已领完
5	未填地址超时
6	未抽中

# PresentUserType（用户类型枚举）

枚举值	描述
0	第三者
1	赠礼者
2	收礼者

# 错误码

错误码	错误描述
详见通用错误码	-
40097	参数错误