说说第三方支付接口开发及开发中遇到的坑爹问题

Posted 2020-07-31 Fly , Mason ! ! !

前言

  最近在做公司的支付接口，从微信支付到各种第三方的支付接口，还有点卡等支付，微信支付文档相对比较详细，虽然也不少坑，被各路开发人员吐槽，但是填的人多啊，所以是最好开发的，但是公司还有用到一些第三方的网页支付接口，然后遇到很多坑，忍不住想吐槽一下。

一、第三方支付流程

  各种支付的文档，业务流程图有的过于简单，有的真的是复杂的不要不要的，开发者看了也是醉，写这些文档的人好像从来不会考虑看的人的感受，所以我觉得有必要在这里简单介绍，我觉得给开发者的流程图大致应该是这样的,而不是一堆用不上的东西在开发文档里面。

再简单化就是：获取接口信息（银行列表等）-》提交参数及签名-》获取结果（需要验证签名）

我们做接口开发  能力多么强的程序员，不看文档也是没有办法做的，签名算法是人家做接口的人提供的，参数也是人家命名的，所以学会看文档是很重要的，看过大量别人写的文档，我们才可以写出简单明了的文档了，这是经验之谈。

二、开发中遇到的那些坑

有写坑是文档的坑，有些坑是人为的坑，反正坑你没商量。

1.微信支付

  之前做微信支付，从官方文档下载了asp.net的开发demo，替换好了参数，按照官方的步骤一步一步来，想先测试支付成功后，再对接系统，坑的是我恰好用的是苹果手机，恰好官方asp.net的demo里面支付按钮拖的是一个控件，在安卓上支付没有问题，在苹果手机上却不可以，然后我再不知情的情况下我硬是搞了半天，看看代码注释明显不是C#的注释方式，多半是做java的抓过来把java版本修改的。然后网上搜了一下，发现好多人被这个问题坑到！

2.环讯支付

  ①环讯支付提供了测试的商户id和密钥，并且提供了webservice接口获取对应银行的名称和代号，方便开发直连支付模式，但是根据接口，获取到的银行列表的银行代号竟然有重复的，我一直以为是我接口调用有问题，再三确认，真的是提供接口的太随意了；②支付接口的商户号下来了，我尝试着去支付，改了正式的接口和商户信息，然后支付，结果链接失败，错误码#E008，我查文档，没有，百度，没有，找人问，不知道···然后我咨询他们官方客服，官方客服转接到技术客服，反正各种麻烦，对方说是域名没绑定，我也是醉。公司让我开发，就给了文档和商户信息，其他的都没有，我以为只要微信才需要绑定域名呢。然后让客服给个错误码的文档，对方非要我提供商户号才肯给····不知道这错误码还是什么机密么？

3.新生支付

  ①这个官方提供的文档就更离谱了，我看了文档是2011年写的，pdf是2013年生成的，然后上面也是提供了测试的地址，地址不是真的可访问的地址，需要修改hosts文件，重定向到指定的域名。我做好了准备测试的时候，发现一直提示网页链接错误。纳闷，当然我肯定是从自己身上找问题，是不是host文件修改的不对，或者是其他什么问题。经过我再三确认 各种ping 发现测试地址是不可用的，于是找度年，没结果，问小伙伴，没结果，好了，该去找官方客服，然后对接技术客服，问他们要最新的文档，及测试地址是换了么？然后对方给我的答复是测试地址是不可用的，我现在在用的文档（2011年写的13年最后修改）是最新的，测试不可以用 你给各种测试的一堆东西干嘛？

  ②直连的时候有个参数是必填的，用户付款账号，我觉得逻辑很奇怪，就问技术客服，结果对方给的答复是只要是邮箱和手机格式的，随便填就可以···

  ③这个平台没有提供接口获取银行列表，所有的银行参数都要手动写，而且有变动的话也只能手动改！

4.关于文档

  不明白的点是官方网站上怎么没有网页版的开发文档，word或者pdf方便，但是如果接口更新了什么东西开发者第一时间怎么修改呢？

三、案列代码

环讯支付的接口代码

1.获取银行列表

 1 #region 环讯网银支付接口 WebService获取银行列表信息BankList()（暂时是测试的接口）
 2 PayServiceIps.ServiceSoapClient IpsPay = new PayServiceIps.ServiceSoapClient();//调用webservice 此处是测试地址
 3 protected List<string> Array;
 4 //获取银行列表
 5 //格式为  银行|银行别名|银行代号的数组
 6 protected List<string> BankList()
 7 {
 8     string Mer_code = System.Configuration.ConfigurationManager.AppSettings["Mer_code"];//商户号
 9     string Mer_key = System.Configuration.ConfigurationManager.AppSettings["Mer_key"];//商户证书：登陆http://merchant.ips.com.cn/商户后台下载的商户证书内容
10     string Re = IpsPay.GetBankList(Mer_code, Game.Utils.Utility.MD5(Mer_code + Mer_key).ToLower());
11     Re = HttpUtility.UrlDecode(Re);//Re的格式为银行|银行别名|银行代号#
12     List<string> ArrayList = new List<string>();
13     for (int i = 0; i < (Re.Split(\'#\').Length - 1); i++)//数组是以#结束的 所以最后一个字符串是空的
14     {
15         ArrayList.Add(Re.Split(\'#\')[i]);
16     }
17     return ArrayList;
18 }
19 #endregion

2.支付跳转到第三方页面

 1 #region 配置支付参数并且跳转到支付
 2 //提交地址
 3 //string form_url = "http://pay.ips.net.cn/ipayment.aspx"; //测试
 4 string form_url = "https://pay.ips.com.cn/ipayment.aspx"; //正式
 5 //商户号
 6 string Mer_code = System.Configuration.ConfigurationManager.AppSettings["Mer_code"];
 7 //商户证书：登陆http://merchant.ips.com.cn/商户后台下载的商户证书内容
 8 string Mer_key = System.Configuration.ConfigurationManager.AppSettings["Mer_key"];
 9 //商户订单编号
10 string Billno = orderInfo.OrderID;// 
11 //订单金额(保留2位小数)
12 string Amount = this.txtSalePrice.Text.Trim() + ".00";
13 //订单日期
14 string BillDate = DateTime.Now.ToString("yyyyMMdd");
15 //币种
16 string Currency_Type = "RMB";
17 //支付卡种
18 string Gateway_Type = "01";
19 //银行代号
20 string Bankco = Bankco;
21 //语言
22 string Lang = "GB";
23 string nurl = "http://" + Request.Url.Authority + "/Return.aspx";
24 //支付结果成功返回的商户URL
25 string Merchanturl = nurl;
26 //支付结果失败返回的商户URL
27 string FailUrl = "http://" + Request.Url.Authority + "/FailUrl.aspx";
28 //商户数据包
29 string Attach = Amount;
30 //显示金额
31 string DispAmount = Amount;
32 //订单支付接口加密方式
33 string OrderEncodeType = "5";
34 //交易返回接口加密方式 
35 string RetEncodeType = "17";
36 //返回方式
37 string Rettype = "1";
38 //Server to Server 返回页面URL
39 string ServerUrl = nurl;
40 //订单支付接口的Md5摘要， 原文=billno+订单编号+ currencytype +币种+ amount +订单金额+ date +订单日期+ orderencodetype +订单支付接口加密方式+商户内部证书字符串
41 string SignMD5 = System.Web.Security.FormsAuthentication.HashPasswordForStoringInConfigFile("billno" + Billno + "currencytype" + Currency_Type + "amount" + Amount + "date" + BillDate + "orderencodetype" + OrderEncodeType + Mer_key, "MD5").ToLower();
42 string postForm = "<form name=\\"frm1\\" id=\\"frm1\\" method=\\"post\\" action=\\"" + form_url + "\\">";
43 postForm += "<input type=\\"hidden\\" name=\\"Mer_code\\" value=\\"" + Mer_code + "\\" />";
44 postForm += "<input type=\\"hidden\\" name=\\"Billno\\" value=\\"" + Billno + "\\" />";
45 postForm += "<input type=\\"hidden\\" name=\\"Amount\\" value=\\"" + Amount + "\\" />";
46 postForm += "<input type=\\"hidden\\" name=\\"Date\\" value=\\"" + BillDate + "\\" />";
47 postForm += "<input type=\\"hidden\\" name=\\"Currency_Type\\" value=\\"" + Currency_Type + "\\" />";
48 postForm += "<input type=\\"hidden\\" name=\\"Gateway_Type\\" value=\\"" + Gateway_Type + "\\" />";
49 postForm += "<input type=\\"hidden\\" name=\\"Lang\\" value=\\"" + Lang + "\\" />";
50 postForm += "<input type=\\"hidden\\" name=\\"Merchanturl\\" value=\\"" + Merchanturl + "\\" />";
51 postForm += "<input type=\\"hidden\\" name=\\"FailUrl\\" value=\\"" + FailUrl + "\\" />";
52 postForm += "<input type=\\"hidden\\" name=\\"Attach\\" value=\\"" + Attach + "\\" />";
53 postForm += "<input type=\\"hidden\\" name=\\"Bankco\\" value=\\"" + Bankco + "\\" />";
54 postForm += "<input type=\\"hidden\\" name=\\"DispAmount\\" value=\\"" + DispAmount + "\\" />";
55 postForm += "<input type=\\"hidden\\" name=\\"OrderEncodeType\\" value=\\"" + OrderEncodeType + "\\" />";
56 postForm += "<input type=\\"hidden\\" name=\\"RetEncodeType\\" value=\\"" + RetEncodeType + "\\" />";
57 postForm += "<input type=\\"hidden\\" name=\\"Rettype\\" value=\\"" + Rettype + "\\" />";
58 postForm += "<input type=\\"hidden\\" name=\\"ServerUrl\\" value=\\"" + ServerUrl + "\\" />";
59 postForm += "<input type=\\"hidden\\" name=\\"SignMD5\\" value=\\"" + SignMD5 + "\\" />";
60 if (Bankco != "")
61     postForm += "<input type=\\"hidden\\" name=\\"DoCredit\\" value=\\"1\\">";
62 postForm += "</form>";
63 //自动提交该表单到测试网关
64 postForm += "<script type=\\"text/javascript\\" language=\\"javascript\\">setTimeout(\\"document.getElementById(\'frm1\').submit();\\",10);</script>";
65 #endregion

3.结果返回

 1 //接收数据
 2 string billno = Request["billno"];
 3 string amount = Request["amount"];//+".00";
 4 string currency_type = Request["Currency_type"];
 5 string mydate = Request["date"];
 6 string succ = Request["succ"];
 7 string msg = Request["msg"];
 8 string attach = Request["attach"];
 9 string ipsbillno = Request["ipsbillno"];
10 string retEncodeType = Request["retencodetype"];
11 string signature = Request["signature"];
12 string bankbillno = Request["bankbillno"];
13 //签名原文
14 //billno+【订单编号】+currencytype+【币种】+amount+【订单金额】+date+【订单日期】+succ+【成功标志】+ipsbillno+【IPS订单编号】+retencodetype +【交易返回签名方式】
15 string content = "billno" + billno + "currencytype" + currency_type + "amount" + amount + "date" + mydate + "succ" + succ + "ipsbillno" + ipsbillno + "retencodetype" + retEncodeType;
16 //签名是否正确
17 Boolean verify = false;
18 
19 //验证方式：16-md5withRSA  17-md5
20 
21 // if (retEncodeType == "17")
22 //{
23 //登陆http://merchant.ips.com.cn/商户后台下载的商户证书内容
24 string merchant_key = System.Configuration.ConfigurationManager.AppSettings["Mer_key"];
25 //Md5摘要
26 string signature1 = FormsAuthentication.HashPasswordForStoringInConfigFile(content + merchant_key, "MD5").ToLower();
27 
28 if (signature1 == signature)
29 {
30     verify = true;
31 }
32 
33 //判断签名验证是否通过
34 if (verify == true)
35 {
36     //判断交易是否成功
37     if (succ != "Y")
38     {
39         Response.Write("<script>alert(\\"交易失败！\\");</script>");
40         Response.End();
41     }
42     else
43     {
44 
45         Response.Write("<script>alert(\\"交易成功！\\");</script>");
46         Response.End();
47     }
48 }
49 else
50 {
51     Response.Write("签名不正确！");
52 }