本文我将详细介绍微信红包开发的接口,商户调用接口时,通过指定发送对象以及发送金额的方式发放红包,领取到红包后,用户的资金直接进入微信零钱。后面带有具体调用php实例
微信支付现金红包接口正式开放,只需开通微信支付,即可接入现金红包。通过现金红包接口,公众号开发者可以策划相关活动,向用户发放微信支付现金红包,更好的达到品牌推广及回馈用户的效果。具体能力如下:
1、商户调用接口时,通过指定发送对象以及发送金额的方式发放红包,这样的方式,允许商户灵活的应用于各种各样丰富的活动场景
2、领取到红包后,用户的资金直接进入微信零钱,避免繁复的领奖流程,带给用户微信支付原生的流畅体验
。微信支付商户号会在商户申请微信支付成功后,通过开户邮件发送给您。请不要使用微信公众平台账号或者appid登录。如果您登录时遇到问题,请联系微信支付小助手weixinpay@/
是(证书及使用说明详见商户证书) |
* 作用:产生随机字符串,不长于32位 * 作用:格式化参数,签名过程需要使用 //签名步骤一:按字典序排序参数 //签名步骤三:MD5加密 //签名步骤四:所有字符转为大写 //这里设置代理,如果有的话 //以下两种方式需选择一种 //默认格式为PEM,可以注释 //默认格式为PEM,可以注释 //第二种方式,两个文件合成一个.pem文件 |
◆ 每分钟发送红包数量不得超过1800个;
◆ 同一个商户号,每分钟最多给同一个用户发送一个红包;
◆ 单个红包金额介于[获取升级指引)
◆ 红包发放后72小时未被领取将进行退款
◆ 每分钟发送红包数量不得超过1800个;
◆ 北京时间0:00-8:00不触发红包赠送;
(如果以上规则不满足您的需求,请发邮件至wxhongbao@获取升级指引)
随机字符串,不长于32位 |
商户订单号(每个订单号必须唯一) 接口根据商户订单号支持重入,如出现超时可再调用。 |
微信分配的公众账号ID(企业号corpid即为此appId)。接口传入的所有appid应该为公众号的appid(在申请的),不能为APP的appid(在申请的)。 |
感谢您参加猜灯谜活动,祝您元宵节快乐! |
申请的),不能为APP的appid(在申请的)。 |
发放失败,此请求可能存在风险,已被微信拦截 | 请提醒用户检查自身帐号是否异常。使用常用的活跃的微信号可避免这种情况。 | |
该用户今日领取红包个数超过限制 | 该用户今日领取红包个数超过你在微信支付商户平台配置的上限 | 如有需要、请在微信支付商户平台【api安全】中重新配置 【每日同一用户领取本商户红包不允许超过的个数】。 |
接口传入的所有appid应该为公众号的appid(在申请的),不能为APP的appid(在申请的)。 | ||
发送红包金额不再限制范围内 | 4、如果以上3步都没有问题,把请求串中(post的数据)里面中文都去掉,换成英文,试下,看看是否是编码问题。(post的数据要求是utf8) | |
请求已受理,请稍后使用原单号查询发放结果 | 系统无返回明确发放结果 | 使用原单号调用接口,查询发放结果,如果使用新单号调用接口,视为新发放请求 |
输入xml参数格式错误 | 请求的xml格式错误,或者post的数据为空 | 检查请求串,确认无误后重试 |
超过频率限制,请稍后再试 | 请对请求做频率控制(可联系微信支付wxhongbao@申请的),不能为APP的appid(在申请的)。 | |
接收红包的种子用户(首个用户) |
||
红包发放总金额,即一组红包金额总和,包括分享者的红包和裂变的红包,单位分 | ||
红包发放总人数,即总共有多少人可以领到该组红包(包括分享者) | ||
ALL_RAND—全部随机,商户指定总金额和红包发放总人数,由微信支付随机计算出各红包金额 |
||
感谢您参加猜灯谜活动,祝您元宵节快乐! | ||
猜越多得越多,快来抢! |
此字段是通信标识,非交易标识,交易是否成功需要查看result_code来判断 |
返回信息,如非空,为错误原因 |
商户订单号(每个订单号必须唯一) |
微信分配的公众账号ID(企业号corpid即为此appId) |
发放失败,此请求可能存在风险,已被微信拦截 | 请提醒用户检查自身帐号是否异常。使用常用的活跃的微信号可避免这种情况。 |
该用户今日领取红包个数超过限制 | 如有需要、请在微信支付商户平台【api安全】中重新配置 【每日同一用户领取本商户红包不允许超过的个数】。 |
请求未携带证书,或请求携带的证书出错 | 到商户平台下载证书,请求带上证书后重试。 |
接口传入的所有appid应该为公众号的appid(在申请的),不能为APP的appid(在申请的)。 | |
按文档要求重新生成签名后再重试。 | |
请求的xml格式错误,或者post的数据为空 | 检查请求串,确认无误后重试 |
请查看err_code_des,修改设置错误的参数 | |
根据用户在商家公众账号上的openid,获取用户在红包公众账号上的openid 错误。请核对商户自身公众号appid和用户在此公众号下的openid。 | |
商户账号余额不足,请登录微信支付商户平台充值 | |
重复请求时,参数与原单不一致 | 使用相同商户单号进行重复请求时,参数与第一次请求时不一致,请检查并修改参数后再重试。 |
企业红包的按分钟发放受限 | 每分钟发送红包数量不得超过1800个;(可联系微信支付wxhongbao@调高额度) |
83 $amt_type = "ALL_RAND"; //红包金额设置方式 ALL_RAND—全部随机,商户指定总金额和红包发放总人数,由微信支付随机计算出各红包金额 122 //这里设置代理,如果有的话 129 //以下两种方式需选择一种 135 //默认格式为PEM,可以注释 140 //第二种方式,两个文件合成一个.pem文件 |