前言:最近做了App的支付功能,虽然最后的代码只有巴掌大,但是踩坑的经历真的是异常丰富,问就是官方坑爹的版本升级和core少的可怜的参考资料(望天)。 

阅读本文章您将收获到:1.微信和支付宝支付的保姆级后端教程

                                         2.官方文档解析

                                        3.独家的踩坑提示

                                        4.一个本地可运行的demo

注意事项:1. 仅后端代码部分,不涉及任何前端

                  2.仅APP支付

代码demo:      https://files-cdn.cnblogs.com/files/rulasann/PayUtil.zip  (已重新上传)

 

 


 

part1:支付宝App支付

 1.官方文档:

    https://opendocs.alipay.com/apis/api_1/alipay.trade.app.pay

 2.参数说明(请结合官方文档阅读):

    有两种参数类型,公共参数和请求参数,如果调用官方的SDK,公共参数中的sign不需要自己签。例:

IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);

    公共参数中的biz_content即为请求参数,这里可不参照官方给的示例写,他们有封装好的model。例:

//以下为发起请求的最简参数
AlipayTradeAppPayModel model = new AlipayTradeAppPayModel(); model.TotalAmount = "0.01"; // 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000] //model.Body = ""; // 商品描述 model.Subject = "交易标题"; // 商品标题/交易标题/订单标题/订单关键字等 model.OutTradeNo = ""; // 商户订单号,由商家自定义,需保证商家系统中唯一。仅支持数字、字母、下划线 model.ProductCode = "QUICK_MSECURITY_PAY"; // 销售产品码,商家和支付宝签约的产品码。QUICK_MSECURITY_PAY:App支付。 request.SetBizModel(model); // 将业务model载入到request

    关于notify_url,非必填,如果需要,可以这样写:

request.SetNotifyUrl(notify_url)

3.完整请求示例,需Nuget引用AlipaySDKNet.Standard,其次建议用一个实体类封装配置信息:

 1 public class AliPayBasicItem
 2     {
 3         /// <summary>
 4         /// 开发者的应用ID , 必填
 5         /// </summary>
 6         public static string app_id = "";
 7 
 8         /// <summary>
 9         /// 请求使用的编码格式
10         /// </summary>
11         public static string charset = "utf-8";
12 
13         /// <summary>
14         /// 仅支持"JSON",非必填
15         /// </summary>
16         public static string format = "json";
17 
18         /// <summary>
19         /// 签名算法
20         /// </summary>
21         public static string sign_type = "RSA2";
22 
23         /// <summary>
24         /// 调用的接口版本 
25         /// </summary>
26         public static string version = "1.0";
27 
28         /// <summary>
29         /// 支付宝请求url
30         /// </summary>
31         public static string url = "https://openapi.alipay.com/gateway.do";
32 
33         /// <summary>
34         /// 商户私钥 (必填)
35         /// </summary>
36         public static string merchant_private_key = "";
37 
38         /// <summary>
39         /// 支付宝公钥 (必填)
40         /// </summary>
41         public static string alipay_public_key = "";
42 
43         /// <summary>
44         /// 支付完成后的通知地址 非必填
45         /// </summary>
46         public static string pay_notify_url = "";
47 
48         /// <summary>
49         /// 币种
50         /// </summary>
51         public static string currency = "CNY";
52 
53         /// <summary>
54         /// 退款完成后的通知地址 非必填
55         /// </summary>
56         //public static string refund_notify_url = "";
57 
58         /// <summary>
59         /// 应用名称
60         /// </summary>
61         public static string app_name = "mc";
62 
63         /// <summary>
64         /// 签约号 (必填)
65         /// </summary>
66         public static string pid = "";
67     }
View Code
 1 public string AppPay()
 2         {
 3             IAopClient client = new DefaultAopClient(AliPayBasicItem.url, AliPayBasicItem.app_id, AliPayBasicItem.merchant_private_key, AliPayBasicItem.format, AliPayBasicItem.version, AliPayBasicItem.sign_type, AliPayBasicItem.alipay_public_key, AliPayBasicItem.charset, false);
 4             AlipayTradeAppPayRequest request = new AlipayTradeAppPayRequest();
 5 
 6             AlipayTradeAppPayModel model = new AlipayTradeAppPayModel();
 7             model.TotalAmount = "0.01"; // 订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
 8             //model.Body = ""; // 商品描述
 9             model.Subject = "交易标题"; // 商品标题/交易标题/订单标题/订单关键字等
10             model.OutTradeNo = ""; // 商户订单号,由商家自定义,需保证商家系统中唯一。仅支持数字、字母、下划线
11             model.ProductCode = "QUICK_MSECURITY_PAY"; // 销售产品码,商家和支付宝签约的产品码。QUICK_MSECURITY_PAY:App支付。
12             request.SetBizModel(model);  // 将业务model载入到request
13             //request.SetNotifyUrl(AliPayBasicItem.pay_notify_url); 
14 
15             AlipayTradeAppPayResponse response = client.SdkExecute(request);
16             var info = response.Body;
17 
18             return info   // 将这里的info直接返给前端          
19         }
View Code

4.响应:

有坑注意:官方给的响应示例是个json,实际上我们拿到的(即上面示例中的info)并不长这样,如下图所示,是加密过的,看不懂没关系,不需要处理,直接返给前端就好,由前端拿着那长串去唤起支付,至此支付过程结束。

 5.支付结果处理:

如果notify_url 赋了值,支付宝会将支付结果post给这个接口,处理一下接收数据

② 可主动调用查询接口去获取支付结果 https://opendocs.alipay.com/apis/api_1/alipay.trade.query ,写法跟支付类似,封装的model为AlipayTradeQueryModel

 


 

 part2:微信App支付

 1.官方文档:

   https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_2_1.shtml

   有坑注意:微信支付接口已经升级到v3版本,网上找的示例可能还是老版本,区别是,老版本为MD5加密,参数格式为XML,新版本为SHA2加密,参数格式为json

 2.参数说明:

   官方给的请求参数如下图,没什么好说的,就一个json:

   

   *金额total是int类型;

   *notify_url与支付宝不同,微信是必填,官方建议是https且无端口号,实际上http加有端口号也是可以的(不建议哈);

3.签名:

   需手动对接口参数签名,签名过程参考:https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_0.shtml ,以下以微信支付为例:

①拼接待签名字符串:请求方法\n+URL\n+时间戳\n+随机字符串\n+请求参数\n

TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
string time_str = Convert.ToInt64(ts.TotalSeconds).ToString();
string sign_url = "/v3/pay/transactions/app";
string nonce_str = Guid.NewGuid().ToString().Replace("-", "");
string body_str = "";  // 上面的参数
string to_sign = "POST" + "\n" + sign_url + "\n" + time_str + "\n" + nonce_str + "\n" + body_str + "\n";

②使用商户私钥对待签名串进行SHA256 with RSA签名,并对签名结果进行Base64编码得到签名值

byte[] keyData = Convert.FromBase64String(key);
using (CngKey cngKey = CngKey.Import(keyData, CngKeyBlobFormat.Pkcs8PrivateBlob))
using (RSACng rsa = new RSACng(cngKey))
{
    byte[] data = System.Text.Encoding.UTF8.GetBytes(to_sign);
    string sign = Convert.ToBase64String(rsa.SignData(data, HashAlgorithmName.SHA256, RSASignaturePadding.Pkcs1));
}

③设置请求头:Authorization: 认证类型 签名信息

    认证类型为:WECHATPAY2-SHA256-RSA2048

    签名信息为:商户号mchid+商户API证书serial_no+请求随机串nonce_str+时间戳timestamp+签名值sign

string value = $"WECHATPAY2-SHA256-RSA2048 " + "mchid=\"" + mch_id + "\",serial_no=\"" + serial_no + "\",nonce_str=\"" + nonce_str + "\",timestamp=\"" + time_str + "\",signature=\"" + sign + "\"";
request.Headers.Add("Authorization", value);

   有坑注意:请求头还需有以下设置,不然会报400

request.ContentType = "application/json;charset=utf-8";
request.Headers.Add("Accept", "application/json");
request.Headers.Add("User-Agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)");

4.返回值处理:

  请参考https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_2_4.shtml

  以上是前端调起支付要用到的字段,由后端通过返回值拼接处理而成

5.完整代码示例:

①要用到的实体类 

  1  public class WxPayBasicItem
  2     {
  3         /// <summary>
  4         /// 小程序ID
  5         /// </summary>
  6         public static string appid = "";
  7 
  8         /// <summary>
  9         /// 商户号
 10         /// </summary>
 11         public static string mch_id = "";
 12 
 13         /// <summary>
 14         /// 商户证书序列号
 15         /// </summary>
 16         public static string serial_no = "";
 17 
 18         /// <summary>
 19         /// 商户私钥
 20         /// </summary>
 21         public static string private_key = "";
 22 
 23         /// <summary>
 24         /// 小程序支付请求url
 25         /// </summary>
 26         //public static string order_url = "https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi";
 27 
 28         /// <summary>
 29         /// app支付请求url
 30         /// </summary>
 31         public static string app_url = "https://api.mch.weixin.qq.com/v3/pay/transactions/app";
 32 
 33         /// <summary>
 34         /// 预支付完成后的通知地址
 35         /// </summary>
 36         public static string order_notify_url = "https://weixin.qq.com/"; 
 37 
 38         /// <summary>
 39         /// 交易类型 小程序取值"JSAPI"
 40         /// </summary>
 41         //public static string trade_type = "JSAPI";
 42 
 43         /// <summary>
 44         /// 查询订单请求url
 45         /// </summary>
 46         public static string query_url = "https://api.mch.weixin.qq.com/v3/pay/transactions/id";
 47 
 48         /// <summary>
 49         /// 应用密钥 
 50         /// </summary>
 51         //public static string secret = "";
 52 
 53         /// <summary>
 54         /// 授权登录url
 55         /// </summary>
 56         public static string auth_login_url = "https://api.weixin.qq.com/sns/oauth2/access_token";
 57 
 58         /// <summary>
 59         /// 微信获取用户信息url
 60         /// </summary>
 61         public static string wx_user_url = "https://api.weixin.qq.com/sns/userinfo";
 62     }
 63 
 64     /// <summary>
 65     /// App预支付参数
 66     /// </summary>
 67     public class AppPaymentData
 68     {
 69         /// <summary>
 70         /// 小程序ID
 71         /// </summary>
 72         //[Required]
 73         public string appid { get; set; }
 74 
 75         /// <summary>
 76         /// 商户号
 77         /// </summary>
 78         public string mchid { get; set; }
 79 
 80         /// <summary>
 81         /// 商品描述 商品简单描述,不超过128字节
 82         /// </summary>
 83         public string description { get; set; }
 84 
 85         /// <summary>
 86         /// 商户订单号
 87         /// </summary>
 88         public string out_trade_no { get; set; }
 89 
 90         /// <summary>
 91         /// 交易结束时间 yyyyMMddHHmmss,非必填
 92         /// </summary>
 93         //public string time_expire { get; set; }
 94 
 95         /// <summary>
 96         /// 附加数据 非必填
 97         /// </summary>
 98         //public string attach { get; set; }
 99 
100         /// <summary>
101         /// 异步通知地址 通知url必须为外网可访问的url,不能携带参数。
102         /// </summary>
103         public string notify_url { get; set; }
104 
105         /// <summary>
106         /// 订单优惠标记
107         /// </summary>
108         //public string goods_tag { get; set; }
109 
110         /// <summary>
111         /// 订单金额信息
112         /// </summary>
113         public PaymentDataAmount amount { get; set; }
114 
115         /// <summary>
116         /// 场景信息
117         /// </summary>
118         //public PaymentDataScene scene_info { get; set; }
119 
120         /// <summary>
121         /// 结算信息
122         /// </summary>
123         //public PaymentDataSettle settle_info { get; set; }
124     }
125 
126     /// <summary>
127     /// 订单金额
128     /// </summary>
129     public class PaymentDataAmount
130     {
131         /// <summary>
132         /// 总金额 订单总金额,单位为分
133         /// </summary>
134         public int total { get; set; }
135 
136         /// <summary>
137         /// 货币类型 非必填,默认"CNY"
138         /// </summary>
139         public string currency { get; set; }
140     }
141 
142     /// <summary>
143     /// App调起支付参数
144     /// </summary>
145     public class AppPayBackItem
146     {
147         /// <summary>
148         /// 应用id
149         /// </summary>
150         public string appid { get; set; }
151 
152         /// <summary>
153         /// 商户号
154         /// </summary>
155         public string partnerid { get; set; }
156 
157         /// <summary>
158         /// 预支付交易会话ID
159         /// </summary>
160         public string prepayid { get; set; }
161 
162         /// <summary>
163         /// 订单详情扩展字符串
164         /// </summary>
165         public string package { get; set; }
166 
167         /// <summary>
168         /// 随机字符串
169         /// </summary>
170         public string noncestr { get; set; }
171 
172         /// <summary>
173         /// 时间戳
174         /// </summary>
175         public string timestamp { get; set; }
176 
177         /// <summary>
178         /// 签名
179         /// </summary>
180         public string sign { get; set; }
181 
182     }
View Code

②工具类

 1 public static class WxPayMethod
 2     {
 3         /// <summary>
 4         /// 微信app下单
 5         /// </summary>
 6         public static string PayTest(AppPaymentData item)
 7         {
 8             var param = JsonConvert.SerializeObject(item);
 9 
10             string sign_url = WxPayBasicItem.app_url.Split(".com")[1].ToString();
11             string time_str = GetTimeStamp();
12             string nonce_str = GetNonceStr();
13             string body_str = param;
14 
15             string to_sign_info = "POST" + "\n" + sign_url + "\n" + time_str + "\n" + nonce_str + "\n" + body_str + "\n";
16             string sign_info = RsaSign(to_sign_info, WxPayBasicItem.private_key);
17 
18             HttpWebRequest request = (HttpWebRequest)WebRequest.Create(WxPayBasicItem.app_url);
19             request.Method = "POST";
20             string value = $"WECHATPAY2-SHA256-RSA2048 " + "mchid=\"" + WxPayBasicItem.mch_id + "\",serial_no=\"" + WxPayBasicItem.serial_no + "\",nonce_str=\"" + nonce_str + "\",timestamp=\"" + time_str + "\",signature=\"" + sign_info + "\"";
21             request.Headers.Add("Authorization", value);
22             request.ContentType = "application/json;charset=utf-8";
23             request.Headers.Add("Accept", "application/json");
24             request.Headers.Add("User-Agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)");
25 
26             byte[] bs = Encoding.UTF8.GetBytes(param);
27             request.ContentLength = bs.Length;
28             if (bs.Length > 0)
29             {
30                 using (Stream reqStream = request.GetRequestStream())
31                 {
32                     reqStream.Write(bs, 0, bs.Length);
33                     reqStream.Close();
34                 }
35             }
36             HttpWebResponse response = (HttpWebResponse)request.GetResponse();
37             if (response.StatusCode == HttpStatusCode.OK)
38             {
39                 using (Stream mystream = response.GetResponseStream())
40                 {
41                     using (StreamReader reader = new StreamReader(mystream))
42                     {
43                         var info = reader.ReadToEnd();
44                         return info;
45                     }
46                 }
47             }
48             else
49             {
50                 return "";
51             }
52         }
53 
54         /// <summary>
55         /// Rsa签名
56         /// </summary>
57         /// <param name="str"></param>
58         /// <param name="key"></param>
59         /// <returns></returns>
60         public static string RsaSign(string str, string key)
61         {
62             var result = string.Empty;
63 
64             byte[] keyData = Convert.FromBase64String(key);
65             using (CngKey cngKey = CngKey.Import(keyData, CngKeyBlobFormat.Pkcs8PrivateBlob))
66             using (RSACng rsa = new RSACng(cngKey))
67             {
68                 byte[] data = System.Text.Encoding.UTF8.GetBytes(str);
69                 result = Convert.ToBase64String(rsa.SignData(data, HashAlgorithmName.SHA256, RSASignaturePadding.Pkcs1));
70             }
71 
72             return result;
73         }
74 
75         /// <summary>
76         /// 生成随机字符串
77         /// </summary>
78         /// <returns></returns>
79         public static string GetNonceStr()
80         {
81             return Guid.NewGuid().ToString().Replace("-", "");
82         }
83 
84         /// <summary>
85         /// 生成时间戳,标准北京时间,时区为东八区,自1970年1月1日 0点0分0秒以来的秒数
86         /// </summary>
87         /// <returns></returns>
88         public static string GetTimeStamp()
89         {
90             TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
91             return Convert.ToInt64(ts.TotalSeconds).ToString();
92         }
93     }
View Code

③主方法

public AppPayBackItem AppOrder()
        {
            var pay_item = new AppPaymentData();
            pay_item.amount = new PaymentDataAmount();
            string url = WxPayBasicItem.app_url;

            pay_item.appid = WxPayBasicItem.appid;
            pay_item.mchid = WxPayBasicItem.mch_id;
            pay_item.description = ""; //交易描述
            pay_item.out_trade_no = ""; //商户订单号,商户系统中唯一
            pay_item.notify_url = WxPayBasicItem.order_notify_url;
            pay_item.amount.total = 1; //这里是int类型,单位为分
            pay_item.amount.currency = "CNY";

            string response = WxPayMethod.PayTest(pay_item);

            if (!string.IsNullOrEmpty(response))
            {
                //处理返回结果
                string prepayid = ((JObject)JsonConvert.DeserializeObject(response))["prepay_id"].ToString();
                var info = new AppPayBackItem();
                info.appid = WxPayBasicItem.appid;
                info.partnerid = WxPayBasicItem.mch_id;
                info.prepayid = prepayid;
                info.package = "Sign=WXPay"; // 照着填
                info.noncestr = WxPayMethod.GetNonceStr();
                info.timestamp = WxPayMethod.GetTimeStamp();
                string to_sign = info.appid + "\n" + info.timestamp + "\n" + info.noncestr + "\n" + info.prepayid + "\n";
                info.sign = WxPayMethod.RsaSign(to_sign, WxPayBasicItem.private_key);

                return  info;  //把这个返回给前端就行               
            }
            else
            {
                // 失败
            }

        }
View Code

6.支付结果处理:与支付宝类似 

7.辅助工具建议:

①微信官方的加签验签工具   (如果是自己写签名方法的,建议用这个测一下)

②http请求工具:Advanced-REST-client(网上一搜一大把教程,这个诚心推荐!不然微信支付能测到你怀疑人生!当然其它模拟请求工具也是可以的)