商家确认回调领券事件

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

必须先调用该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