/* 错误码 描述 解决方案 NO_AUTH 发放失败,此请求可能存在风险,已被微信拦截 请提醒用户检查自身帐号是否异常。使用常用的活跃的微信号可避免这种情况。 SENDNUM_LIMIT 该用户今日领取红包个数超过限制 如有需要、请在微信支付商户平台【api安全】中重新配置 【每日同一用户领取本商户红包不允许超过的个数】。 CA_ERROR 请求未携带证书,或请求携带的证书出错 到商户平台下载证书,请求带上证书后重试。 ILLEGAL_APPID 错误传入了app的appid 接口传入的所有appid应该为公众号的appid(在mp.weixin.qq.com申请的),不能为APP的appid(在open.weixin.qq.com申请的)。 SIGN_ERROR 商户签名错误 按文档要求重新生成签名后再重试。 FREQ_LIMIT 受频率限制 请对请求做频率控制 XML_ERROR 请求的xml格式错误,或者post的数据为空 检查请求串,确认无误后重试 PARAM_ERROR 参数错误 请查看err_code_des,修改设置错误的参数 OPENID_ERROR Openid错误 根据用户在商家公众账号上的openid,获取用户在红包公众账号上的openid 错误。请核对商户自身公众号appid和用户在此公众号下的openid。 NOTENOUGH 余额不足 商户账号余额不足,请登录微信支付商户平台充值 FATAL_ERROR 重复请求时,参数与原单不一致 使用相同商户单号进行重复请求时,参数与第一次请求时不一致,请检查并修改参数后再重试。 SECOND_OVER_LIMITED 企业红包的按分钟发放受限 每分钟发送红包数量不得超过1800个;(可联系微信支付[email protected]调高额度) DAY_ OVER_LIMITED 企业红包的按天日发放受限 单个商户日发送红包数量不大于10000个;(可联系微信支付[email protected]调高额度) MONEY_LIMIT 红包金额发放限制 每个红包金额必须大于1元,小于1000元(可联系微信支付[email protected]调高额度至4999元) SEND_FAILED 红包发放失败,请更换单号再重试 原商户单号已经失败,如果还要对同一个用户发放红包, 需要更换新的商户单号再试。 SYSTEMERROR 系统繁忙,请再试。 可用同一商户单号再次调用,只会发放一个红包 PROCESSING 请求已受理,请稍后使用原单号查询发放结果 二十分钟后查询,按照查询结果成功失败进行处理 */ #endregion /// <summary> /// 普通红包发送 /// </summary> /// <param name="appId">公众账号AppID</param> /// <param name="mchId">商户MchID</param> /// <param name="tenPayKey">支付密钥,微信商户平台(pay.weixin.qq.com)-->账户设置-->API安全-->密钥设置</param> /// <param name="tenPayCertPath">证书地址(硬盘物理地址,形如E:\\cert\\apiclient_cert.p12)</param> /// <param name="openId">要发红包的用户的OpenID</param> /// <param name="senderName">红包发送者名称,会显示给接收红包的用户</param> /// <param name="iP">发送红包的服务器地址</param> /// <param name="redPackAmount">红包金额(单位分)</param> /// <param name="wishingWord">祝福语</param> /// <param name="actionName">活动名称</param> /// <param name="remark">活动描述,用于低版本微信显示</param> /// <param name="nonceStr">将nonceStr随机字符串返回,开发者可以存到数据库用于校验</param> /// <param name="paySign">将支付签名返回,开发者可以存到数据库用于校验</param> /// <param name="scene">场景id(非必填)</param> /// <param name="riskInfo">活动信息(非必填),String(128)posttime:用户操作的时间戳。 /// <para>示例:posttime%3d123123412%26clientversion%3d234134%26mobile%3d122344545%26deviceid%3dIOS</para> /// <para>mobile:业务系统账号的手机号,国家代码-手机号。不需要+号</para> /// <para>deviceid :mac 地址或者设备唯一标识</para> /// <para>clientversion :用户操作的客户端版本</para> /// <para>把值为非空的信息用key = value进行拼接,再进行urlencode</para> /// <para>urlencode(posttime= xx & mobile = xx & deviceid = xx)</para> /// </param> /// <param name="consumeMchId">资金授权商户号,服务商替特约商户发放时使用(非必填),String(32)。示例:1222000096</param> /// <returns></returns> public static NormalRedPackResult SendNormalRedPack(string appId, string mchId, string tenPayKey, string tenPayCertPath, string openId, string senderName, string iP, int redPackAmount, string wishingWord, string actionName, string remark, out string nonceStr, out string paySign, RedPack_Scene? scene = null, string riskInfo = null, string consumeMchId = null) { string mchbillno = GetNewBillNo(mchId); nonceStr = TenPayV3Util.GetNoncestr(); //RequestHandler packageReqHandler = new RequestHandler(null); //string accessToken = AccessTokenContainer.GetAccessToken(ConstantClass.AppID); //UserInfoJson userInforResult = UserApi.Info(accessToken, openID); RequestHandler packageReqHandler = new RequestHandler(); //设置package订单参数 packageReqHandler.SetParameter("nonce_str", nonceStr); //随机字符串 packageReqHandler.SetParameter("wxappid", appId); //公众账号ID packageReqHandler.SetParameter("mch_id", mchId); //商户号 packageReqHandler.SetParameter("mch_billno", mchbillno); //填入商家订单号 packageReqHandler.SetParameter("send_name", senderName); //红包发送者名称 packageReqHandler.SetParameter("re_openid", openId); //接受收红包的用户的openId packageReqHandler.SetParameter("total_amount", redPackAmount.ToString()); //付款金额,单位分 packageReqHandler.SetParameter("total_num", "1"); //红包发放总人数 packageReqHandler.SetParameter("wishing", wishingWord); //红包祝福语 packageReqHandler.SetParameter("client_ip", iP); //调用接口的机器Ip地址 packageReqHandler.SetParameter("act_name", actionName); //活动名称 packageReqHandler.SetParameter("remark", remark); //备注信息 paySign = packageReqHandler.CreateMd5Sign("key", tenPayKey); packageReqHandler.SetParameter("sign", paySign); //签名 if (scene.HasValue) { packageReqHandler.SetParameter("scene_id", scene.Value.ToString());//场景id } if (riskInfo != null) { packageReqHandler.SetParameter("risk_info", riskInfo);//活动信息 } if (consumeMchId != null) { packageReqHandler.SetParameter("consume_mch_id", consumeMchId);//活动信息 } //最新的官方文档中将以下三个字段去除了 //packageReqHandler.SetParameter("nick_name", "提供方名称"); //提供方名称 //packageReqHandler.SetParameter("max_value", "100"); //最大红包金额,单位分 //packageReqHandler.SetParameter("min_value", "100"); //最小红包金额,单位分 //发红包需要post的数据 string data = packageReqHandler.ParseXML(); //发红包接口地址 string url = "https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack"; //本地或者服务器的证书位置(证书在微信支付申请成功发来的通知邮件中) string cert = tenPayCertPath; //私钥(在安装证书时设置) string password = mchId; //调用证书 X509Certificate2 cer = new X509Certificate2(cert, password, X509KeyStorageFlags.PersistKeySet | X509KeyStorageFlags.MachineKeySet); ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult); //X509Certificate cer = new X509Certificate(cert, password); #region 发起post请求 HttpWebRequest webrequest = (HttpWebRequest)HttpWebRequest.Create(url); webrequest.ClientCertificates.Add(cer); webrequest.Method = "post"; byte[] postdatabyte = Encoding.UTF8.GetBytes(data); webrequest.ContentLength = postdatabyte.Length; Stream stream = webrequest.GetRequestStream(); stream.Write(postdatabyte, 0, postdatabyte.Length); stream.Close(); HttpWebResponse httpWebResponse = (HttpWebResponse)webrequest.GetResponse(); StreamReader streamReader = new StreamReader(httpWebResponse.GetResponseStream()); string responseContent = streamReader.ReadToEnd(); #endregion XmlDocument doc = new XmlDocument(); doc.LoadXml(responseContent); //XDocument xDoc = XDocument.Load(responseContent); NormalRedPackResult normalReturn = new NormalRedPackResult { err_code = "", err_code_des = "" }; if (doc.SelectSingleNode("/xml/return_code") != null) { normalReturn.return_code = (doc.SelectSingleNode("/xml/return_code").InnerText.ToUpper() == "SUCCESS"); } if (doc.SelectSingleNode("/xml/return_msg") != null) { normalReturn.return_msg = doc.SelectSingleNode("/xml/return_msg").InnerText; } if (normalReturn.return_code == true) { //redReturn.sign = doc.SelectSingleNode("/xml/sign").InnerText; if (doc.SelectSingleNode("/xml/result_code") != null) { normalReturn.result_code = (doc.SelectSingleNode("/xml/result_code").InnerText.ToUpper() == "SUCCESS"); } if (normalReturn.result_code == true) { if (doc.SelectSingleNode("/xml/mch_billno") != null) { normalReturn.mch_billno = doc.SelectSingleNode("/xml/mch_billno").InnerText; } if (doc.SelectSingleNode("/xml/mch_id") != null) { normalReturn.mch_id = doc.SelectSingleNode("/xml/mch_id").InnerText; } if (doc.SelectSingleNode("/xml/wxappid") != null) { normalReturn.wxappid = doc.SelectSingleNode("/xml/wxappid").InnerText; } if (doc.SelectSingleNode("/xml/re_openid") != null) { normalReturn.re_openid = doc.SelectSingleNode("/xml/re_openid").InnerText; } if (doc.SelectSingleNode("/xml/total_amount") != null) { normalReturn.total_amount = doc.SelectSingleNode("/xml/total_amount").InnerText; } //裂变红包才有 if (doc.SelectSingleNode("/xml/send_time") != null) { normalReturn.send_time = doc.SelectSingleNode("/xml/send_time").InnerText; } //裂变红包才有 if (doc.SelectSingleNode("/xml/send_listid") != null) { normalReturn.send_listid = doc.SelectSingleNode("/xml/send_listid").InnerText; } } else { if (doc.SelectSingleNode("/xml/err_code") != null) { normalReturn.err_code = doc.SelectSingleNode("/xml/err_code").InnerText; } if (doc.SelectSingleNode("/xml/err_code_des") != null) { normalReturn.err_code_des = doc.SelectSingleNode("/xml/err_code_des").InnerText; } if (doc.SelectSingleNode("/xml/mch_billno") != null) { normalReturn.mch_billno = doc.SelectSingleNode("/xml/mch_billno").InnerText; } if (doc.SelectSingleNode("/xml/mch_id") != null) { normalReturn.mch_id = doc.SelectSingleNode("/xml/mch_id").InnerText; } if (doc.SelectSingleNode("/xml/wxappid") != null) { normalReturn.wxappid = doc.SelectSingleNode("/xml/wxappid").InnerText; } if (doc.SelectSingleNode("/xml/re_openid") != null) { normalReturn.re_openid = doc.SelectSingleNode("/xml/re_openid").InnerText; } if (doc.SelectSingleNode("/xml/total_amount") != null) { normalReturn.total_amount = doc.SelectSingleNode("/xml/total_amount").InnerText; } } } return normalReturn; }
/* * 错误码 描述 解决方案 * NO_AUTH 发放失败,此请求可能存在风险,已被微信拦截 请提醒用户检查自身帐号是否异常。使用常用的活跃的微信号可避免这种情况。 * SENDNUM_LIMIT 该用户今日领取红包个数超过限制 如有需要、请在微信支付商户平台【api安全】中重新配置 【每日同一用户领取本商户红包不允许超过的个数】。 * CA_ERROR 请求未携带证书,或请求携带的证书出错 到商户平台下载证书,请求带上证书后重试。 * ILLEGAL_APPID 错误传入了app的appid 接口传入的所有appid应该为公众号的appid(在mp.weixin.qq.com申请的),不能为APP的appid(在open.weixin.qq.com申请的)。 * SIGN_ERROR 商户签名错误 按文档要求重新生成签名后再重试。 * FREQ_LIMIT 受频率限制 请对请求做频率控制 * XML_ERROR 请求的xml格式错误,或者post的数据为空 检查请求串,确认无误后重试 * PARAM_ERROR 参数错误 请查看err_code_des,修改设置错误的参数 * OPENID_ERROR Openid错误 根据用户在商家公众账号上的openid,获取用户在红包公众账号上的openid 错误。请核对商户自身公众号appid和用户在此公众号下的openid。 * NOTENOUGH 余额不足 商户账号余额不足,请登录微信支付商户平台充值 * FATAL_ERROR 重复请求时,参数与原单不一致 使用相同商户单号进行重复请求时,参数与第一次请求时不一致,请检查并修改参数后再重试。 * SECOND_OVER_LIMITED 企业红包的按分钟发放受限 每分钟发送红包数量不得超过1800个;(可联系微信支付[email protected]调高额度) * DAY_ OVER_LIMITED 企业红包的按天日发放受限 单个商户日发送红包数量不大于10000个;(可联系微信支付[email protected]调高额度) * MONEY_LIMIT 红包金额发放限制 每个红包金额必须大于1元,小于1000元(可联系微信支付[email protected]调高额度至4999元) * SEND_FAILED 红包发放失败,请更换单号再重试 原商户单号已经失败,如果还要对同一个用户发放红包, 需要更换新的商户单号再试。 * SYSTEMERROR 系统繁忙,请再试。 可用同一商户单号再次调用,只会发放一个红包 * PROCESSING 请求已受理,请稍后使用原单号查询发放结果 二十分钟后查询,按照查询结果成功失败进行处理 */ #endregion /// <summary> /// 普通红包发送 /// </summary> /// <param name="appId">公众账号AppID</param> /// <param name="mchId">商户MchID</param> /// <param name="tenPayKey">支付密钥,微信商户平台(pay.weixin.qq.com)-->账户设置-->API安全-->密钥设置</param> /// <param name="tenPayCertPath">证书地址(硬盘物理地址,形如E:\\cert\\apiclient_cert.p12)</param> /// <param name="openId">要发红包的用户的OpenID</param> /// <param name="senderName">红包发送者名称,会显示给接收红包的用户</param> /// <param name="iP">发送红包的服务器地址</param> /// <param name="redPackAmount">付款金额,单位分。红包金额大于200时,请求参数scene必传。</param> /// <param name="wishingWord">祝福语</param> /// <param name="actionName">活动名称</param> /// <param name="remark">活动描述,用于低版本微信显示</param> /// <param name="nonceStr">将nonceStr随机字符串返回,开发者可以存到数据库用于校验</param> /// <param name="paySign">将支付签名返回,开发者可以存到数据库用于校验</param> /// <param name="mchBillNo">商户订单号,新的订单号可以从RedPackApi.GetNewBillNo(mchId)方法获得,如果传入null,则系统自动生成</param> /// <param name="scene">场景id(非必填),红包金额大于200时,请求参数scene必传</param> /// <param name="riskInfo">活动信息(非必填),String(128)posttime:用户操作的时间戳。 /// <para>示例:posttime%3d123123412%26clientversion%3d234134%26mobile%3d122344545%26deviceid%3dIOS</para> /// <para>mobile:业务系统账号的手机号,国家代码-手机号。不需要+号</para> /// <para>deviceid :mac 地址或者设备唯一标识</para> /// <para>clientversion :用户操作的客户端版本</para> /// <para>把值为非空的信息用key = value进行拼接,再进行urlencode</para> /// <para>urlencode(posttime= xx & mobile = xx & deviceid = xx)</para> /// </param> /// <param name="consumeMchId">资金授权商户号,服务商替特约商户发放时使用(非必填),String(32)。示例:1222000096</param> /// <returns></returns> public static NormalRedPackResult SendNormalRedPack(string appId, string mchId, string tenPayKey, string tenPayCertPath, string openId, string senderName, string iP, int redPackAmount, string wishingWord, string actionName, string remark, out string nonceStr, out string paySign, string mchBillNo, RedPack_Scene?scene = null, string riskInfo = null, string consumeMchId = null) { mchBillNo = mchBillNo ?? GetNewBillNo(mchId); nonceStr = TenPayV3Util.GetNoncestr(); //RequestHandler packageReqHandler = new RequestHandler(null); //string accessToken = AccessTokenContainer.GetAccessToken(ConstantClass.AppID); //UserInfoJson userInforResult = UserApi.Info(accessToken, openID); RequestHandler packageReqHandler = new RequestHandler(); //设置package订单参数 packageReqHandler.SetParameter("nonce_str", nonceStr); //随机字符串 packageReqHandler.SetParameter("wxappid", appId); //公众账号ID packageReqHandler.SetParameter("mch_id", mchId); //商户号 packageReqHandler.SetParameter("mch_billno", mchBillNo); //填入商家订单号 packageReqHandler.SetParameter("send_name", senderName); //红包发送者名称 packageReqHandler.SetParameter("re_openid", openId); //接受收红包的用户的openId packageReqHandler.SetParameter("total_amount", redPackAmount.ToString()); //付款金额,单位分 packageReqHandler.SetParameter("total_num", "1"); //红包发放总人数 packageReqHandler.SetParameter("wishing", wishingWord); //红包祝福语 packageReqHandler.SetParameter("client_ip", iP); //调用接口的机器Ip地址 packageReqHandler.SetParameter("act_name", actionName); //活动名称 packageReqHandler.SetParameter("remark", remark); //备注信息 if (scene.HasValue) { packageReqHandler.SetParameter("scene_id", scene.Value.ToString());//场景id } if (riskInfo != null) { packageReqHandler.SetParameter("risk_info", riskInfo);//活动信息 } if (consumeMchId != null) { packageReqHandler.SetParameter("consume_mch_id", consumeMchId);//活动信息 } paySign = packageReqHandler.CreateMd5Sign("key", tenPayKey); packageReqHandler.SetParameter("sign", paySign); //签名 //最新的官方文档中将以下三个字段去除了 //packageReqHandler.SetParameter("nick_name", "提供方名称"); //提供方名称 //packageReqHandler.SetParameter("max_value", "100"); //最大红包金额,单位分 //packageReqHandler.SetParameter("min_value", "100"); //最小红包金额,单位分 //发红包需要post的数据 string data = packageReqHandler.ParseXML(); //发红包接口地址 string url = "https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack"; //本地或者服务器的证书位置(证书在微信支付申请成功发来的通知邮件中) string cert = tenPayCertPath; //私钥(在安装证书时设置) string password = mchId; //调用证书 X509Certificate2 cer = new X509Certificate2(cert, password, X509KeyStorageFlags.PersistKeySet | X509KeyStorageFlags.MachineKeySet); #if NET35 || NET40 || NET45 || NET461 ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult); //X509Certificate cer = new X509Certificate(cert, password); #region 发起post请求 HttpWebRequest webrequest = (HttpWebRequest)HttpWebRequest.Create(url); webrequest.ClientCertificates.Add(cer); webrequest.Method = "post"; byte[] postdatabyte = Encoding.UTF8.GetBytes(data); webrequest.ContentLength = postdatabyte.Length; Stream stream = webrequest.GetRequestStream(); stream.Write(postdatabyte, 0, postdatabyte.Length); stream.Close(); HttpWebResponse httpWebResponse = (HttpWebResponse)webrequest.GetResponse(); StreamReader streamReader = new StreamReader(httpWebResponse.GetResponseStream()); string response = streamReader.ReadToEnd(); #endregion #else #region 发起post请求 HttpClientHandler handler = new HttpClientHandler(); handler.ClientCertificates.Add(cer); HttpClient client = new HttpClient(handler); HttpContent hc = new StringContent(data); var request = client.PostAsync(url, hc).Result; var response = request.Content.ReadAsStreamAsync().Result; #endregion #endif XmlDocument doc = new XmlDocument(); //doc.LoadXml(responseContent); doc.Load(response); //XDocument xDoc = XDocument.Load(responseContent); NormalRedPackResult normalReturn = new NormalRedPackResult { err_code = "", err_code_des = "" }; if (doc.SelectSingleNode("/xml/return_code") != null) { normalReturn.return_code = doc.SelectSingleNode("/xml/return_code").InnerText; } if (doc.SelectSingleNode("/xml/return_msg") != null) { normalReturn.return_msg = doc.SelectSingleNode("/xml/return_msg").InnerText; } if (normalReturn.ReturnCodeSuccess) { //redReturn.sign = doc.SelectSingleNode("/xml/sign").InnerText; if (doc.SelectSingleNode("/xml/result_code") != null) { normalReturn.result_code = doc.SelectSingleNode("/xml/result_code").InnerText; } if (normalReturn.ResultCodeSuccess) { if (doc.SelectSingleNode("/xml/mch_billno") != null) { normalReturn.mch_billno = doc.SelectSingleNode("/xml/mch_billno").InnerText; } if (doc.SelectSingleNode("/xml/mch_id") != null) { normalReturn.mch_id = doc.SelectSingleNode("/xml/mch_id").InnerText; } if (doc.SelectSingleNode("/xml/wxappid") != null) { normalReturn.wxappid = doc.SelectSingleNode("/xml/wxappid").InnerText; } if (doc.SelectSingleNode("/xml/re_openid") != null) { normalReturn.re_openid = doc.SelectSingleNode("/xml/re_openid").InnerText; } if (doc.SelectSingleNode("/xml/total_amount") != null) { normalReturn.total_amount = doc.SelectSingleNode("/xml/total_amount").InnerText; } //裂变红包才有 if (doc.SelectSingleNode("/xml/send_time") != null) { normalReturn.send_time = doc.SelectSingleNode("/xml/send_time").InnerText; } //裂变红包才有 if (doc.SelectSingleNode("/xml/send_listid") != null) { normalReturn.send_listid = doc.SelectSingleNode("/xml/send_listid").InnerText; } } else { if (doc.SelectSingleNode("/xml/err_code") != null) { normalReturn.err_code = doc.SelectSingleNode("/xml/err_code").InnerText; } if (doc.SelectSingleNode("/xml/err_code_des") != null) { normalReturn.err_code_des = doc.SelectSingleNode("/xml/err_code_des").InnerText; } if (doc.SelectSingleNode("/xml/mch_billno") != null) { normalReturn.mch_billno = doc.SelectSingleNode("/xml/mch_billno").InnerText; } if (doc.SelectSingleNode("/xml/mch_id") != null) { normalReturn.mch_id = doc.SelectSingleNode("/xml/mch_id").InnerText; } if (doc.SelectSingleNode("/xml/wxappid") != null) { normalReturn.wxappid = doc.SelectSingleNode("/xml/wxappid").InnerText; } if (doc.SelectSingleNode("/xml/re_openid") != null) { normalReturn.re_openid = doc.SelectSingleNode("/xml/re_openid").InnerText; } if (doc.SelectSingleNode("/xml/total_amount") != null) { normalReturn.total_amount = doc.SelectSingleNode("/xml/total_amount").InnerText; } } } return(normalReturn); }