商家确认回调领券事件 | 微信开放文档

# 商家确认回调领券事件

为防止未接入领券能力时导入优惠券，造成优惠券无法领取的问题，接入前需先确认回调领券事件。

必须先调用该API接通领券功能之后，才能调用创建优惠券等其他API。

# 注意

为防止回调冲突，造成优惠券领取出错，所以最终回调地址，以最晚确认回调领券事件的地址为准。

# 接口调用请求说明

http请求方式：POST
https://api.weixin.qq.com/shop/coupon/confirm?access_token=xxxxxxxxx

# 请求参数示例

{
}

# 回包示例

{
  "errcode": 0
}

# 回调请求逻辑

微信收到API请求后，会主动回调商家固定信息的领券事件，商家需返回下文所示结果以确认，否则无法调用优惠券其他API。

# 回调请求参数示例

以商家设置的数据格式（json或xml）为准，这里以xml为例

<xml>
    <ToUserName>gh_abcdefg</ToUserName> 
    <FromUserName>oABCD</FromUserName> 
    <CreateTime>1627747200</CreateTime>
    <MsgType>event</MsgType> 
    <Event>open_product_receive_coupon</Event>
    <out_coupon_id>test_coupon</out_coupon_id>
    <request_id>test_coupon_request_id</request_id>
</xml>

# 回调回包示例

以商家设置的数据格式（json或xml）为准，这里以xml为例

<xml> 
  <out_user_coupon_id>test_coupon_user_coupon_id</out_user_coupon_id>  
  <request_id>test_coupon_request_id</request_id>  
  <ret_code>0</ret_code>  
  <out_coupon_id>test_coupon</out_coupon_id> 
</xml>

# 回调请求参数说明

参数	类型	说明
ToUserName	string	商家小程序名称
FromUserName	string	微信团队的 OpenID(固定值)
CreateTime	number	事件时间,Unix时间戳,单位为秒
MsgType	string	消息类型,固定为 event
Event	string	事件类型,本接口固定为 open_product_receive_coupon
out_coupon_id	string	商家端优惠券ID,商家确认固定为 test_coupon
request_id	string	请求唯一ID,商家确认固定为 test_coupon_request_id

# 回调回包参数说明

参数	类型	说明
ret_code	number	0：成功
out_user_coupon_id	string	商家侧用户优惠券ID,商家确认固定为 test_coupon_user_coupon_id
out_coupon_id	string	商家侧优惠券ID,商家确认固定为 test_coupon
request_id	string	请求唯一ID,商家确认固定为 test_coupon_request_id