# 优惠券返还通知

# 接口说明

视频号小店会通过该接口将优惠券返还的消息通知给商户。

# 注意事项

  • 回调url设置和消息推送规则需参考消息推送文档 ,如果设置的回调url无法访问,商户将无法收视频号小店发送的通知;

# 请求参数说明

参数 类型 描述
ToUserName string 小店UserName
FromUserName string 优惠券返还用户的OpenID
CreateTime number 事件时间,Unix时间戳。即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数
MsgType string 消息类型,固定为 event
Event string 事件类型,本接口固定为 channels_ec_user_coupon_unuse
use_info object UserCouponUnuseEvent 事件主体,结构体详情请参考UserCouponInfoEvent

# 请求参数示例(解密后的明文JSON)

{
    "ToUserName": "gh_*",
    "FromUserName": "OpenID",
    "CreateTime": 1662480000,
    "MsgType": "event",
    "Event": "channels_ec_user_coupon_unuse",
    "use_info": {
        "coupon_id": "19126",
        "user_coupon_id": "29730",
        "order_id": "3705115058471208928",
        "unuse_time": "1662480000"
    }
}

# 回包参数说明

只需直接返回字符串

success

# 返回参数示例

success

# 结构体

# UserCouponUnuseEvent

事件主体

参数 类型 描述
coupon_id string 优惠券ID
user_coupon_id string 用户优惠券ID
order_id string 用券的订单ID
unuse_time string 返还时间