H5发券接口文档
产品介绍
产品介绍
接入指引
接口规则
开发指引
公共API
H5发券
联系我们
联系我们

H5发券API

最新更新时间:2020.04.24 版本说明


微信支付为商户提供H5发券接口,商户可在H5页面中向指定用户发放指定批次的微信支付商家券。

接口说明

适用对象:微信支付商户 服务商

接口规则:http://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=4_3

H5接入操作

1、发券方式

用户在商户H5页面触发领券操作后,通过Url跳转,由商户H5重定向至指定微信支付H5页面(https://action.weixin.qq.com/busifavor/getcouponinfo)并添加指定参数,用户在微信支付H5页面中点击领券后,将自动给用户发券。
注:每一个H5领券域名后,都需添加#wechat_redirect,否则会报错,返回268435461错误码


https://action.weixin.qq.com/busifavor/getcouponinfo?stock_id=1234567890000000&out_request_no=201911280000&sign=D0D028212D200DC9DASDFSDFFD3676BEAD03046DC3A2E82A64C784EFFAF&send_coupon_merchant=123456789&open_id=oiSFDIOoijdsf#wechat_redirect

2、URL中参数

商户需在Url中携带用户信息及批次信息方可正常发券,具体参数如下:

参数名 变量 类型[长度限制] 必填 描述
批次号 stock_id string[1,20] 微信支付商家券批次号
发券凭证 out_request_no string[1,128] 发券凭证(示例格式:商户 id+日期+流水号),可包含英文字母、数字,不允许出现其他不合法符号,商户侧需保证发放凭据号唯一性
签名 sign string 签名计算值。 
签名方式:HMAC-SHA256。 
签名规则:详见《V2 签名规则》
参与签名字段说明
注意:为了安全,签名必须在后台服务器计算,禁止在H5中计算,签名 key 为微信支付 apiv2 的 signkey
示例值:9A0A8659F005D6984697E2CA0A9CF3B79A0A8659F005D6984697E2CA0A9CF3B7
发券商户号 send_coupon_merchant string[1,15] 调用发券接口的商户号
用户openid open_id string[1,128] 目标发券的用户openid

返回处理

由于H5发券采用的是Url重定向的形式,故无法直接将发券结果返回给商户。
建议商户调用【根据过滤条件查询用户券】接口及【查询用户单张券详情】接口,查询发券接口。


举例:用户领券完成并返回商家H5后,商家可自行触发刷新事件,使用【根据过滤条件查询用户券】接口,通过创建商户号、批次号、openid,查询用户是否已成功领取指定批次券,以及领取券的具体code。

错误码

如果发券失败,错误码将在发券结果页面展示给用户及开发者,开发者可根据该页面展示的错误码查询失败原因。


为保证用户体验,部分易懂的错误原因将直接展示给用户。


发券结果(send_coupon_result)中的错误码


错误码 描述 解决方案
268455936 发券参数错误,请检查发券参数 请检查发券参数
272758302,272756756 批次已过期 请检查批次时间
272758303,272756737,272757763 批次预算不足 请检查批次预算
272756738 该批次已达到单天发放上限 请检查批次单天发放上限
272756740 用户领取券张数已达上限 请检查用户领取情况
272756753 用户已领取过这张券 请检查用户领取情况
272756739 自然人限领拦截 请停止发放给该用户
272756743 批次状态不合法,检查该批次是否处于运营中 请检查批次状态
272756762  指定Code发券模式下, 当前发券Code已被使用 请更换Code后重试
272755722 批次不存在 请检查批次号是否正确
272755713 用户安全防刷拦截(潜在羊毛党、黑产用户) 请停止发放给该用户
272758292 未获取到用户信息,需重试 请检查用户信息是否正确
272758286 openid不正确 请检查openid是否正确
272758293 签名错误 请检查签名是否正确
272758295,272758304 系统超时,请重试 请稍后重试
272756755 发券商户号必须为制券商户号或券归属商户号 请检查发券商户号是否为制券商户号或券归属商户号
272756757 用户openid对应的appid必须与发券商户号有绑定关系 请检查用户openid对应的appid与发券商户号是否有绑定关系
268435461 H5领券域名参数错误 每一个H5领券域名后,都需添加#wechat_redirect,请检查是否添加
272756767 指定Code发券模式下, 没有填写指定Code信息 请检查发券参数,检查是否有填写Coupon_code
272757252 无权限操作 请检查调用发券接口的发券商户号与批次号之间的关系,是否未批次的创建方或归属方或有合作授权关系


版本说明

关闭
V1.1
2020年04月24日
1. 新增“268435461”错误码
V1.0
2019年12月19日
1. H5发券接口上线

技术咨询

文档反馈