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

前言

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

一、第三方支付流程

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

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

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

二、开发中遇到的那些坑

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

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 }