微信支付现金红包接口(转)

微信支付现金红包接口正式开放,只需开通微信支付,即可接入现金红包。通过现金红包接口,公众号开发者可以策划相关运营活动,向用户发放微信支付现金红包,更好的达到品牌推广及回馈用户的效果。具体能力如下:

1、商户调用接口时,通过指定发送对象以及发送金额的方式发放红包,这样的方式,允许商户灵活的应用于各种各样丰富的活动场景

2、领取到红包后,用户的资金直接进入微信零钱,避免繁复的领奖流程,带给用户微信支付原生的流畅体验

  

微信红包发送规则

1. 发送频率规则

 ◆ 每分钟发送红包数量不得超过1800个;

 ◆ 北京时间0:00-8:00不触发红包赠送;(如果以上规则不满足您的需求,请发邮件至[email protected]获取升级指引)

2. 红包规则

 ◆ 单个红包金额介于[1.00元,200.00元]之间;

 ◆ 同一个红包只能发送给一个用户;(如果以上规则不满足您的需求,请发邮件至[email protected]获取升级指引)

商户侧调用红包接口流程

1. 登录微信支付商户平台下载证书以及充值

在调用接口前,请商户使用微信支付商户号登录微信支付商户平台完成下述工作:

备注:

微信支付商户平台地址为pay.weixin.qq.com。微信支付商户号会在商户申请微信支付成功后,通过开户邮件发送给您。请不要使用微信公众平台账号或者appid登录。如果您登录时遇到问题,请联系微信支付小助手[email protected]

 ◆ 下载证书

商户调用微信红包接口时,服务器会进行证书验证,请在商户平台下载证书

 ◆ 充值

 发放现金红包将扣除商户的可用余额,请注意,可用余额并不是微信支付交易额,需要预先充值,确保可用余额充足。查看可用余额、充值、提现请登录微信支付商户平台,进入“资金管理”菜单,进行操作

2. 微信红包接口调用流程

 ◆ 后台API调用:待进入联调过程时与开发进行详细沟通;

 ◆ 告知服务器:告知服务器接收微信红包的用户openID,告知服务器该用户获得的金额;

 ◆ 从商务号扣款:服务器获取信息后从对应的商务号扣取对应的金额;

 ◆ 调用失败:因不符合发送规则,商务号余额不足等原因造成调用失败,反馈至调用方;

 ◆ 发送成功:以微信红包公众账号发送对应红包至对应用户;

用户交互流程

调用现金红包接口,发放成功后,用户领取红包流程如下:

步骤(一):收到领取红包消息,步骤(二):点击领取消息,拆红包

  

接口详细说明

1.红包发放说明

用于企业向微信用户个人发现金红包

目前支持向指定微信用户的openid发放指定金额红包。(获取openid参见微信公众平台开发者文档: 网页授权获取用户基本信息

接口参数与用户领用实际效果对应关系如下:

如需操作请登录https://pay.weixin.qq.com/

2.接口调用请求说明


请求Url


https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack


是否需要证书


是(证书及使用说明详见商户证书


请求方式


POST

3.请求参数


字段名


字段


必填


示例值


类型


说明


随机字符串


nonce_str



5K8264ILTKCH16CQ2502SI8ZNMTM67VS


String(32)


随机字符串,不长于32位


签名


sign



C380BEC2BFD727A4B6845133519F3AD6


String(32)


详见签名生成算法


商户订单号


mch_billno



10000098201411111234567890


String(28)


商户订单号(每个订单号必须唯一)

组成: mch_id+yyyymmdd+10位一天内不能重复的数字。

接口根据商户订单号支持重入, 如出现超时可再调用。


商户号


mch_id



10000098


String(32)


微信支付分配的商户号


子商户号


sub_mch_id



10000090


String(32)


微信支付分配的子商户号,受理模式下必填


公众账号appid


wxappid



wx8888888888888888


String(32)


商户appid


提供方名称


nick_name



天虹百货


String(32)


提供方名称


商户名称


send_name



天虹百货


String(32)


红包发送者名称


用户openid


re_openid



oxTWIuGaIt6gTKsQRLau2M0yL16E


String(32)


接受收红包的用户

用户在wxappid下的openid


付款金额


total_amount



1000


int


付款金额,单位分


最小红包金额


min_value



1000


int


最小红包金额,单位分


最大红包金额


max_value



1000


int


最大红包金额,单位分

( 最小金额等于最大金额: min_value=max_value =total_amount)


红包发放总人数


total_num



1


int


红包发放总人数

total_num=1


红包祝福语


wishing



感谢您参加猜灯谜活动,祝您元宵节快乐!


String(128)


红包祝福语


Ip地址


client_ip



192.168.0.1


String(15)


调用接口的机器Ip地址


活动名称


act_name



猜灯谜抢红包活动


String(32)


活动名称


备注


remark



猜越多得越多,快来抢!


String(256)


备注信息


商户logo的url


logo_imgurl



https://wx.gtimg.com/mch/img/ico-logo.png


String(128)


商户logo的url


分享文案


share_content



快来参加猜灯谜活动


String(256)


分享文案


分享链接


share_url



http://www.qq.com


String(128)


分享链接


分享的图片


share_imgurl



https://wx.gtimg.com/mch/img/ico-logo.png


String(128)


分享的图片url

数据示例:


<xml>

<sign></sign>

<mch_billno></mch_billno>

<mch_id></mch_id>

<wxappid></wxappid>

<nick_name></nick_name>

<send_name></send_name>

<re_openid></re_openid>

<total_amount></total_amount>

<min_value></min_value>

<max_value></max_value>

<total_num></total_num>

<wishing></wishing>

<client_ip></client_ip>

<act_name></act_name>

<act_id></act_id>

<remark></remark>

<logo_imgurl></logo_imgurl>

<share_content></share_content>

<share_url></share_url>

<share_imgurl></share_imgurl>

<nonce_str></nonce_str>

</xml>

4.返回参数


字段名


变量名


必填


示例值


类型


说明


返回状态码


return_code



SUCCESS


String(16)


SUCCESS/FAIL

此字段是通信标识,非交易标识,交易是否成功需要查看result_code来判断


返回信息


return_msg



签名失败


String(128)


返回信息,如非空,为错误原因

签名失败

参数格式校验错误


以下字段在return_code为SUCCESS的时候有返回


签名


sign



C380BEC2BFD727A4B6845133519F3AD6


String(32)


生成签名方式详见签名生成算法


业务结果


result_code



SUCCESS


String(16)


SUCCESS/FAIL


错误代码


err_code



SYSTEMERROR


String(32)


错误码信息


错误代码描述


err_code_des



系统错误


String(128)


结果信息描述


以下字段在return_code 和result_code都为SUCCESS的时候有返回


商户订单号


mch_billno



10000098201411111234567890


String(28)


商户订单号(每个订单号必须唯一)

组成: mch_id+yyyymmdd+10位一天内不能重复的数字


商户号


mch_id



10000098


String(32)


微信支付分配的商户号


公众账号appid


wxappid



wx8888888888888888


String(32)


商户appid


用户openid


re_openid



oxTWIuGaIt6gTKsQRLau2M0yL16E


String(32)


接受收红包的用户

用户在wxappid下的openid


付款金额


total_amount



1000


int


付款金额,单位分


发放成功时间


微信单号

成功示例:


<xml>

<return_code><![CDATA[SUCCESS]]></return_code>

<return_msg><![CDATA[发放成功.]]></return_msg>

<result_code><![CDATA[SUCCESS]]></result_code>

<err_code><![CDATA[0]]></err_code>

<err_code_des><![CDATA[发放成功.]]></err_code_des>

<mch_billno><![CDATA[0010010404201411170000046545]]></mch_billno>

<mch_id>10010404</mch_id>

<wxappid><![CDATA[wx6fa7e3bab7e15415]]></wxappid>

<re_openid><![CDATA[onqOjjmM1tad-3ROpncN-yUfa6uI]]></re_openid>

<total_amount>1</total_amount>

</xml>

失败示例:


<xml>

<return_code><![CDATA[FAIL]]></return_code>

<return_msg><![CDATA[系统繁忙,请稍后再试.]]></return_msg>

<result_code><![CDATA[FAIL]]></result_code>

<err_code><![CDATA[268458547]]></err_code>

<err_code_des><![CDATA[系统繁忙,请稍后再试.]]></err_code_des>

<mch_billno><![CDATA[0010010404201411170000046542]]></mch_billno>

<mch_id>10010404</mch_id>

<wxappid><![CDATA[wx6fa7e3bab7e15415]]></wxappid>

<re_openid><![CDATA[onqOjjmM1tad-3ROpncN-yUfa6uI]]></re_openid>

<total_amount>1</total_amount>

</xml>

5.错误码


错误代码


描述


解决方案


NOAUTH


无权限


请联系微信支付开通api权限


PARAM_ERROR


参数错误


请查看err_code_des,修改设置错误的参数


OPENID_ERROR


Openid错误


根据用户在商家公众账号上的openid,获取用户在红包公众账号上的openid 错误。请核对商户自身公众号appid和用户在此公众号下的openid。


NOTENOUGH


余额不足


商户账号余额不足,请登录微信支付商户平台充值


SYSTEMERROR


系统繁忙,请再试。


可用同一商户单号再次调用,只会发放一个红包。


TIME _LIMITED


企业红包的发送时间受限


请北京时间0:00-8:00时间之外触发红包赠送


SECOND_OVER_LIMITED


企业红包的按分钟发放受限


每分钟发送红包数量不得超过1800个;(可联系微信支付[email protected]调高额度)


MONEY_LIMIT


红包金额发放限制


每个红包金额必须大于1元,小于200元(可联系微信支付[email protected]调高额度至4999元)

源代码及演示demo

时间: 2024-10-10 10:49:56

微信支付现金红包接口(转)的相关文章

微信支付现金红包接口

微信支付现金红包接口正式开放,只需开通微信支付,即可接入现金红包.通过现金红包接口,公众号开发者可以策划相关运营活动,向用户发放微信支付现金红包,更好的达到品牌推广及回馈用户的效果.具体能力如下: 1.商户调用接口时,通过指定发送对象以及发送金额的方式发放红包,这样的方式,允许商户灵活的应用于各种各样丰富的活动场景 2.领取到红包后,用户的资金直接进入微信零钱,避免繁复的领奖流程,带给用户微信支付原生的流畅体验 微信红包发送规则 1. 发送频率规则 ◆ 每分钟发送红包数量不得超过1800个: ◆

微信公众号可通过现金红包接口发放微信支付现金红包(附开发教程)

农历新年将至,支付宝红包打了一仗,微信在朋友圈屏蔽了它的分享,但单防守还不行,进攻才是最好的防守.昨日,微信支付现金红包接口正式开放,只需开通微信支付,即可接入现金红包.微信公众号也可以发放现金红包了! 通过现金红包接口,公众号开发者可以策划相关运营活动,向用户发放微信支付现金红包,更好的达到品牌推广及回馈用户的效果. 1.商户调用接口时,通过指定发送对象以及发送金额的方式发放红包,这样的方式,允许商户灵活的应用于各种各样丰富的活动场景 2.领取到红包后,用户的资金直接进入微信零钱,避免繁复的领

微信支付----维权接口开发!(转掌眼)

最近比较忙,没多少时间写!所以这篇可能比较乱,请理解.. 1.你需确定维权URL通知地址: 在“商户功能→商户信息→修改→维权通知URL”查看维权通知URL.(区分大小写) 2.添加用户维权入口 在服务号自定义菜单添加名称叫“维权”的菜单,该菜单不分层级,不分位置,微信自动跳转到维权页面.. 3.获取维权通知XML数据. 在ResponseHandler类(微信支付----没我想的那么难)添加获取XML参数的方法: /**获取XML参数**/ public string getMpParamet

支付宝支付 微信支付SDK接口不统一? 盘他!

??开发过支付宝.微信支付的同学都知道,微信的支付 API 设计感觉是 Java 开发工程师写的,远不如支付宝 SDK 的接口设计用起来顺手.在这里,统一封装微信支付和支付宝支付的API,使两种支付方式对外提供一致的调用接口. ?? 首先我们来看支付宝支付SDK的API是怎么设计的: /** * 支付接口 * * @param orderStr 支付订单信息字串 * @param schemeStr 调用支付的app注册在info.plist中的scheme * @param completio

微信支付 jsapi接口

/// <summary> /// 微信支付成功,返回信息 /// </summary> /// <returns></returns> public void WxZhifuInfo() { string post = ""; HttpRequestBase request = Request; using (System.IO.Stream stream = request.InputStream) { Byte[] postByte

微信支付退款接口

ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult); X509Certificate cer = new X509Certificate(cert, password,X509KeyStorageFlags.PersistKeySet|X509KeyStorageFlags.Exportable|X509Ke

浅析微信支付:商户平台开通现金红包、指定用户发放、红包记录查询

本文是[浅析微信支付]系列文章的第十三篇,主要讲解在如何开通商户平台的红包功能和为用户发放红包,以及查询发送红包记录. 浅析微信支付系列已经更新十三篇了哟-,没有看过的朋友们可以看一下哦. 浅析微信支付:(余额提现)企业付款到微信用户零钱或银行卡账户 浅析微信支付:支付验收示例和验收指引 浅析微信支付:如何使用沙箱环境测试 浅析微信支付:申请退款.退款回调接口.查询退款 上一篇文章我们说到,如果有余额提现.返利福利等需求时,就会用到商家向用户付款的操作,基于微信支付,上篇我们说了付款到用户余额和

个人商家怎么申请微信支付接口

微信支付接口:点击进去 一直让大家翘首以盼的微信最核心的杀手锏——“微信支付”终于开放申请了!今天微信团队在官网发布消息,微信公众平台支付功能已正式开放申请,已开通公众号的开发者可以登录公众平台申请App支付功能.未开通公众号的APP开发者,我们将在近期开放,届时可在微信开放平台申请. 微信官方正式宣布,此前尚处于内测阶段的微信支付接口,即日起对通过微信认证的服务号全面开放.需要申请微信支付接口的商家,首先需要申请成为服务号,并在申请微信认证,签订合同并缴纳保证金后,申请全网发布,即可开通微信支

php微信支付接口开发程序(一)

阅读对象 本文阅读对象:商户系统(在线购物平台.人工收银系统.自动化智能收银系统或其他)集成微信支付涉及的技术架构师,研发工程师,测试工程师,系统运维工程师. 支付模式 1. 刷卡支付 刷卡支付是用户展示微信钱包内的“刷卡条码/二维码”给商户系统扫描后直接完成支付的模式.主要应用线下面对面收银的场景. 2. 扫码支付 扫码支付是商户系统按微信支付协议生成支付二维码,用户再用微信“扫一扫”完成支付的模式.该模式适用于PC网站支付.实体店单品或订单支付.媒体广告支付等场景. 3. 公众号支付 公众号