using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Net.Http; using Codeplex.Data; using Deepleo.Weixin.SDK.Helpers; namespace Deepleo.Weixin.SDK.Pay { /// /// 微信支付 => 公共API /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_1 /// public class WxPayAPI { /// /// 公共API => 统一下单 /// 不需要证书 /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_1# /// 应用场景 ///除被扫支付场景以外,商户系统先调用该接口在微信支付服务后台生成预支付交易单,返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。 /// /// (必填) String(32) 微信分配的公众账号ID /// (必填) String(32) 微信支付分配的商户号 /// String(32) 微信支付分配的终端设备号,商户自定义 /// (必填) String(32) 随机字符串,不长于32位 /// (必填) String(32) 商品描述 商品或支付单简要描 /// String(8192) 商品详情 商品名称明细列表 /// String(127) 附加数据,在查询API和支付通知中原样返回,该字段主要用于商户携带订单的自定义数据 /// (必填) String(32) 商家订单ID,32个字符内、可包含字母, 其他说明见第4.2节商户订单号:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=4_2 /// 符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见第4.2节货币类型: http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=4_2 /// (必填) Int 订单总金额,只能为整数,详见第4.2节支付金额:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=4_2 /// (必填) String(32)终端IP APP和网页支付提交用户端IP,Native支付填调用微信支付API的机器IP。 /// String(14) 订单生成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。 /// String(14) 订单失效时间,格式为yyyyMMddHHmmss,如2009年12月27日9点10分10秒表示为20091227091010。 /// String(32) 商品标记,代金券或立减优惠功能的参数,说明详见第10节代金券或立减优惠:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=10_1 /// (必填) String(256) 接收微信支付异步通知回调地址 /// (必填) String(16) 交易类型,取值如下:JSAPI,NATIVE,APP,详细说明见第4.2节参数规定:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=4_2 /// (trade_type=NATIVE,此参数必传)String(32) 商品ID,trade_type=NATIVE,此参数必传。此id为二维码中包含的商品ID,商户自行定义。 /// (trade_type=JSAPI,此参数必传)String(128)用户标识,trade_type=JSAPI,此参数必传,用户在商户appid下的唯一标识。下单前需要调用【网页授权获取用户信息】接口获取到用户的Openid。 /// API密钥 /// 返回json字符串,格式参见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_1 public static dynamic UnifiedOrder(string appid, string mch_id, string device_info, string nonce_str, string body, string detail, string attach, string out_trade_no, string fee_type, int total_fee, string spbill_create_ip, string time_start, string time_expire, string goods_tag, string notify_url, string trade_type, string product_id, string openid, string partnerKey ) { var stringADict = new Dictionary(); stringADict.Add("appid", appid); stringADict.Add("mch_id", mch_id); stringADict.Add("device_info", device_info); stringADict.Add("nonce_str", nonce_str); stringADict.Add("body", body); stringADict.Add("attach", attach); stringADict.Add("out_trade_no", out_trade_no); stringADict.Add("fee_type", fee_type); stringADict.Add("total_fee", total_fee.ToString()); stringADict.Add("spbill_create_ip", spbill_create_ip); stringADict.Add("time_start", time_start); stringADict.Add("time_expire", time_expire); stringADict.Add("goods_tag", goods_tag); stringADict.Add("notify_url", notify_url); stringADict.Add("trade_type", trade_type); stringADict.Add("product_id", product_id); stringADict.Add("openid", openid); var sign = Sign(stringADict, partnerKey);//生成签名字符串 var postdata =PayUtil.GeneralPostdata(stringADict, sign); var url = "https://api.mch.weixin.qq.com/pay/unifiedorder"; var client = new HttpClient(); var result = client.PostAsync(url, new StringContent(postdata)).Result; if (!result.IsSuccessStatusCode) return string.Empty; return new DynamicXml(result.Content.ReadAsStringAsync().Result); } /// /// 公共API => 查询订单 /// 不需要证书 /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_2 /// 该接口提供所有微信支付订单的查询,商户可以通过该接口主动查询订单状态,完成下一步的业务逻辑。 /// 需要调用查询接口的情况: ///◆ 当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知; ///◆ 调用支付接口后,返回系统错误或未知交易状态情况; ///◆ 调用被扫支付API,返回USERPAYING的状态; ///◆ 调用关单或撤销接口API之前,需确认支付状态; /// /// (必填) String(32) 微信分配的公众账号ID /// (必填) String(32) 微信支付分配的商户号 /// String(32) 微信订单号 微信的订单号,优先使用 /// (transaction_id为空时必填) String(32) 商户订单号 商户系统内部的订单号,当没提供transaction_id时需要传这个。 /// 随机字符串 随机字符串,不长于32位。 /// API密钥 /// 参见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_2 public static dynamic OrderQuery(string appid, string mch_id, string transaction_id, string out_trade_no, string nonce_str, string partnerKey) { var stringADict = new Dictionary(); stringADict.Add("appid", appid); stringADict.Add("mch_id", mch_id); stringADict.Add("transaction_id", transaction_id); stringADict.Add("out_trade_no", out_trade_no); stringADict.Add("nonce_str", nonce_str); var sign = Sign(stringADict, partnerKey);//生成签名字符串 var postdata = PayUtil.GeneralPostdata(stringADict, sign); var url = "https://api.mch.weixin.qq.com/pay/orderquery"; var client = new HttpClient(); var result = client.PostAsync(url, new StringContent(postdata)).Result; if (!result.IsSuccessStatusCode) return string.Empty; //return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result); // 此处返回的是XML不是JSON, 详见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_2 return new DynamicXml(result.Content.ReadAsStringAsync().Result); } /// /// 公共API => 关闭订单 /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_3 /// 应用场景 /// 不需要证书 ///以下情况需要调用关单接口:商户订单支付失败需要生成新单号重新发起支付,要对原订单号调用关单,避免重复支付;系统下单后,用户支付超时,系统退出不再受理,避免用户继续,请调用关单接口。 /// /// (必填) String(32) 微信分配的公众账号ID /// (必填) String(32) 微信支付分配的商户号 /// (transaction_id为空时必填) String(32) 商户订单号 商户系统内部的订单号,当没提供transaction_id时需要传这个。 /// 随机字符串 随机字符串,不长于32位。 /// API密钥 /// 参见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_3 public static dynamic CloseOrder(string appid, string mch_id, string transaction_id, string out_trade_no, string nonce_str, string partnerKey) { var stringADict = new Dictionary(); stringADict.Add("appid", appid); stringADict.Add("mch_id", mch_id); stringADict.Add("transaction_id", transaction_id); stringADict.Add("out_trade_no", out_trade_no); stringADict.Add("nonce_str", nonce_str); var sign = Sign(stringADict, partnerKey);//生成签名字符串 var postdata = PayUtil.GeneralPostdata(stringADict, sign); var url = "https://api.mch.weixin.qq.com/pay/closeorder"; var client = new HttpClient(); var result = client.PostAsync(url, new StringContent(postdata)).Result; if (!result.IsSuccessStatusCode) return string.Empty; return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result); } /// /// 公共API => 申请退款 /// 需要双向证书 /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_4 ///应用场景 ///当交易发生之后一段时间内,由于买家或者卖家的原因需要退款时,卖家可以通过退款接口将支付款退还给买家,微信支付将在收到退款请求并且验证成功之后,按照退款规则将支付款按原路退到买家帐号上。 ///注意: ///1.交易时间超过半年的订单无法提交退款; ///2.微信支付退款支持单笔交易分多次退款,多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。一笔退款失败后重新提交,要采用原来的退款单号。总退款金额不能超过用户实际支付金额。 ///3.接口提交成功后,还需要在微信商户后台由商户管理员审核退款 /// /// (必填) String(32) 微信分配的公众账号ID /// (必填) String(32) 微信支付分配的商户号 /// String(32) 微信支付分配的终端设备号,商户自定义 /// (必填) 随机字符串 随机字符串,不长于32位。 /// String(32) 微信订单号 微信的订单号,优先使用 /// (transaction_id为空时必填) String(32) 商户订单号 transaction_id、out_trade_no二选一,如果同时存在优先级:transaction_id> out_trade_no /// (必填) String(32) 商户退款单号 商户系统内部的退款单号,商户系统内部唯一,同一退款单号多次请求只退一笔 /// (必填) int 总金额 订单总金额,单位为分,只能为整数。 /// (必填) int 退款金额 退款总金额,订单总金额,单位为分,只能为整数 /// String(8) 货币种类 符合ISO 4217标准的三位字母代码,默认人民币:CNY /// (必填) String(32) 操作员 操作员帐号, 默认为商户号mch_id /// API密钥 /// 参见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_4 public static dynamic Refund(string appid, string mch_id, string device_info, string nonce_str, string transaction_id, string out_trade_no, string out_refund_no, int total_fee, int refund_fee, string refund_fee_type, string op_user_id, string partnerKey) { var stringADict = new Dictionary(); stringADict.Add("appid", appid); stringADict.Add("mch_id", mch_id); stringADict.Add("device_info", device_info); stringADict.Add("nonce_str", nonce_str); stringADict.Add("transaction_id", transaction_id); stringADict.Add("out_trade_no", out_trade_no); stringADict.Add("out_refund_no", out_refund_no); stringADict.Add("total_fee", total_fee.ToString()); stringADict.Add("refund_fee", refund_fee.ToString()); stringADict.Add("refund_fee_type", refund_fee_type); stringADict.Add("op_user_id", op_user_id); var sign = Sign(stringADict, partnerKey);//生成签名字符串 var postdata = PayUtil.GeneralPostdata(stringADict, sign); var url = "https://api.mch.weixin.qq.com/secapi/pay/refund"; var client = new HttpClient(); var result = client.PostAsync(url, new StringContent(postdata)).Result; if (!result.IsSuccessStatusCode) return string.Empty; // return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result); // 此处返回的为 XML 不是 Json,详见:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4 return new DynamicXml(result.Content.ReadAsStringAsync().Result); } /// /// 公共API => 查询退款 /// 不需要证书 /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_5 ///应用场景 ///提交退款申请后,通过调用该接口查询退款状态。退款有一定延时,用零钱支付的退款20分钟内到账,银行卡支付的退款3个工作日后重新查询退款状态。 /// /// (必填) String(32) 微信分配的公众账号ID /// (必填) String(32) 微信支付分配的商户号 /// String(32) 微信支付分配的终端设备号,商户自定义 /// (必填) 随机字符串 随机字符串,不长于32位。 /// String(32) 微信订单号 微信的订单号,优先使用 /// String(32) 商户订单号 transaction_id、out_trade_no二选一,如果同时存在优先级:transaction_id> out_trade_no /// String(32) 商户退款单号 商户系统内部的退款单号,商户系统内部唯一,同一退款单号多次请求只退一笔 /// String(28) 微信退款单号 refund_id、out_refund_no、out_trade_no、transaction_id四个参数必填一个,如果同时存在优先级为: refund_id>out_refund_no>transaction_id>out_trade_no /// API密钥 /// 参见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_5 public static dynamic RefundQuery(string appid, string mch_id, string device_info, string nonce_str, string transaction_id, string out_trade_no, string out_refund_no, string refund_id, string partnerKey) { var stringADict = new Dictionary(); stringADict.Add("appid", appid); stringADict.Add("mch_id", mch_id); stringADict.Add("device_info", device_info); stringADict.Add("nonce_str", nonce_str); stringADict.Add("transaction_id", transaction_id); stringADict.Add("out_trade_no", out_trade_no); stringADict.Add("out_refund_no", out_refund_no); stringADict.Add("refund_id", refund_id); var sign = Sign(stringADict, partnerKey);//生成签名字符串 var postdata = PayUtil.GeneralPostdata(stringADict, sign); var url = "https://api.mch.weixin.qq.com/pay/refundquery"; var client = new HttpClient(); var result = client.PostAsync(url, new StringContent(postdata)).Result; if (!result.IsSuccessStatusCode) return string.Empty; return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result); } /// /// 公共API => 下载对账单 /// 不需要证书 /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_6 ///应用场景 ///商户可以通过该接口下载历史交易清单。比如掉单、系统错误等导致商户侧和微信侧数据不一致,通过对账单核对后可校正支付状态。 ///注意: ///1.微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中,跟原支付单订单号一致,bill_type为REVOKED; ///2.微信在次日9点启动生成前一天的对账单,建议商户10点后再获取; ///3.对账单中涉及金额的字段单位为“元”。 /// /// (必填) String(32) 微信分配的公众账号ID /// (必填) String(32) 微信支付分配的商户号 /// String(32) 微信支付分配的终端设备号,商户自定义 /// (必填) 随机字符串 随机字符串,不长于32位。 /// String(8) 对账单日起 下载对账单的日期,格式:20140603 /// String(8) 账单类型 ALL,返回当日所有订单信息,默认值 SUCCESS,返回当日成功支付的订单; REFUND,返回当日退款订单; REVOKED,已撤销的订单 /// API密钥 /// /// 成功时,数据以文本表格的方式返回,第一行为表头,后面各行为对应的字段内容,字段内容跟查询订单或退款结果一致,具体字段说明可查阅相应接口。 /// 参见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_6 public static dynamic Downloadbill(string appid, string mch_id, string device_info, string nonce_str, string bill_date, string bill_type, string partnerKey) { var stringADict = new Dictionary(); stringADict.Add("appid", appid); stringADict.Add("mch_id", mch_id); stringADict.Add("device_info", device_info); stringADict.Add("nonce_str", nonce_str); stringADict.Add("bill_date", bill_date); stringADict.Add("bill_type", bill_type); var sign = Sign(stringADict, partnerKey);//生成签名字符串 var postdata = PayUtil.GeneralPostdata(stringADict, sign); var url = "https://api.mch.weixin.qq.com/pay/refundquery"; var client = new HttpClient(); var result = client.PostAsync(url, new StringContent(postdata)).Result; if (!result.IsSuccessStatusCode) return string.Empty; return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result); } /// /// 公共API => 测速上报 /// 不需要证书 /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_8 ///应用场景 ///商户在调用微信支付提供的相关接口时,会得到微信支付返回的相关信息以及获得整个接口的响应时间。为提高整体的服务水平, ///协助商户一起提高服务质量,微信支付提供了相关接口调用耗时和返回信息的主动上报接口,微信支付可以根据商户侧上报的数据进一步优化网络部署,完善服务监控,和商户更好的协作为用户提供更好的业务体验。 /// /// (必填) String(32) 微信分配的公众账号ID /// (必填) String(32) 微信支付分配的商户号 /// String(32) 微信支付分配的终端设备号,商户自定义 /// (必填) 随机字符串 随机字符串,不长于32位。 /// String(127) 接口URL 上报对应的接口的完整URL,类似: ///https://api.mch.weixin.qq.com/pay/unifiedorder ///对于被扫支付,为更好的和商户共同分析一次业务行为的整体耗时情况,对于两种接入模式,请都在门店侧对一次被扫行为进行一次单独的整体上报,上报URL指定为: ///https://api.mch.weixin.qq.com/pay/micropay/total ///关于两种接入模式具体可参考本文档章节:被扫支付商户接入模式 ///其它接口调用仍然按照调用一次,上报一次来进行。 /// /// Int 接口耗时 接口耗时情况,单位为毫秒 /// String(16) 返回状态码 接口耗时情况,单位为毫秒 /// String(128) 返回信息 返回信息,如非空,为错误原因 :签名失败; 参数格式校验错误 /// String(16) 业务结果 SUCCESS/FAIL /// String(32) 错误代码 /// String(128) 错误代码描述 /// String(32) 商户订单号 商户系统内部的订单号,商户可以在上报时提供相关商户订单号方便微信支付更好的提高服务质量。 /// String(16) 访问接口IP 发起接口调用时的机器IP /// String(14) 商户上报时间 系统时间,格式为yyyyMMddHHmmss,如2009年12月27日9点10分10秒表示为20091227091010。 其他详见第4.2节时间规则:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=4_2 /// API密钥 /// 参见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_8 public static dynamic Report(string appid, string mch_id, string device_info, string nonce_str, string interface_url, string execute_time_, string return_code, string return_msg, string result_code, string err_code, string err_code_des, string out_trade_no, string user_ip, string time, string partnerKey) { var stringADict = new Dictionary(); stringADict.Add("appid", appid); stringADict.Add("mch_id", mch_id); stringADict.Add("device_info", device_info); stringADict.Add("nonce_str", nonce_str); stringADict.Add("interface_url", interface_url); stringADict.Add("execute_time_", execute_time_); stringADict.Add("return_code", return_code); stringADict.Add("return_msg", return_msg); stringADict.Add("result_code", result_code); stringADict.Add("err_code", err_code); stringADict.Add("err_code_des", err_code_des); stringADict.Add("out_trade_no", out_trade_no); stringADict.Add("user_ip", user_ip); stringADict.Add("time", time); var sign = Sign(stringADict, partnerKey);//生成签名字符串 var postdata = PayUtil.GeneralPostdata(stringADict, sign); var url = "https://api.mch.weixin.qq.com/pay/refundquery"; var client = new HttpClient(); var result = client.PostAsync(url, new StringContent(postdata)).Result; if (!result.IsSuccessStatusCode) return string.Empty; return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result); } /// /// 公共API => 转换短链接 /// 不需要证书 /// http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_9 ///应用场景 ///该接口主要用于扫码原生支付模式一中的二维码链接转成短链接(weixin://wxpay/s/XXXXXX),减小二维码数据量,提升扫描速度和精确度。 /// /// (必填) String(32) 微信分配的公众账号ID /// (必填) String(32) 微信支付分配的商户号 /// (必填) String(512) URL链接 需要转换的URL,签名用原串,传输需URL encode /// (必填) 随机字符串 随机字符串,不长于32位。 /// (必填)API密钥 /// 参见:http://pay.weixin.qq.com/wiki/doc/api/index.php?chapter=9_9 public static dynamic ShortUrl(string appid, string mch_id, string long_url, string nonce_str, string partnerKey) { var stringADict = new Dictionary(); stringADict.Add("appid", appid); stringADict.Add("mch_id", mch_id); stringADict.Add("nonce_str", nonce_str); stringADict.Add("long_url", long_url); var sign = Sign(stringADict, partnerKey);//生成签名字符串 var postdata = PayUtil.GeneralPostdata(stringADict, sign); var url = "https://api.mch.weixin.qq.com/tools/shorturl"; var client = new HttpClient(); var result = client.PostAsync(url, new StringContent(postdata)).Result; if (!result.IsSuccessStatusCode) return string.Empty; return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result); } /// /// 生成签名 /// 签名在线验证工具: /// http://mch.weixin.qq.com/wiki/tools/signverify/ /// /// 参与签名生成的参数列表 /// 商家私钥 /// public static string Sign(IDictionary stringADict, string partnerKey) { var sb = new StringBuilder(); foreach (var sA in stringADict.OrderBy(x => x.Key))//参数名ASCII码从小到大排序(字典序); { if (string.IsNullOrEmpty(sA.Value)) continue;//参数的值为空不参与签名; if (string.Compare(sA.Key, "sign", true) == 0) continue; // 参数中为签名的项,不参加计算 sb.Append(sA.Key).Append("=").Append(sA.Value).Append("&"); } var string1 = sb.ToString(); string1 = string1.Remove(string1.Length - 1, 1); sb.Append("key=").Append(partnerKey);//在stringA最后拼接上key=(API密钥的值)得到stringSignTemp字符串 var stringSignTemp = sb.ToString(); var sign = Util.MD5(stringSignTemp, "UTF-8").ToUpper();//对stringSignTemp进行MD5运算,再将得到的字符串所有字符转换为大写,得到sign值signValue。 return sign; } } }