由于苹果审核机制变化,除了JSPatch
等热修复的应用受到影响外,另个影响较大的就是非法集成第三方支付SDK(尤其支付宝)
而审核被拒。但是由于你懂的
的原因,不想走IAP(In App Pay)
,所以当然想到了支付宝 WAP 支付
。完成 WAP 支付大概花了三天多时间,但是有大概一天时间是在等签约
,所以为了让大家和自己有需要的话快速集成,特意做一个总结。涉及 iOS(OC)
和JS(HTML5)
以及PHP
,下面进入正题。
吐槽支付宝开放平台
之前我一直觉得只有微信的开发平台网站比较容易搞混,(一个是微信开放平台,另个是微信公众平台),但是接触支付宝后,深深陷入各个跳转和新旧文档难以自拔(我记得之前没这么乱啊,我知道网站迭代更新向后兼容不易,但是能不能稍微克制一下??)
先扔出个WAP支付开发文档的链接出来,大家最好直接输入链接,搜索引擎慎用。(你能明白花了很长时间研究文档最后发现是老版本的痛苦吗)
WAP支付开发文档
开发步骤
准备工作
- 注册商家等都不说了,很简单
- 虽然之前已经签约过 APP 支付功能,但是做手机网站支付的话还得继续签约手机网站支付功能,注意
APPID
是不一样的。签约网址在这里签约申请,开始的时候我以为我们运营同事已经帮忙申请好,但是最后在调支付宝接口的时候老是报错ISV权限不足
,经过检查才发现是没有签约手机网站支付,提交申请审核时间是一个工作日。所以大家记得提前申请。 - 签约成功后,由于支付宝使用
RSA
数据加密方式,非对称加密,所以在本机可以openssl
生成应用私钥和应用公钥(统称密钥),应用私钥在自己的代码中加密数据的时候会用到,应用公钥配置到支付宝后台产生支付宝公钥进行数据解密。注意下图,配置手机网站支付的时候选择左边的平台开放密钥
,然后找到对应的APPID
产品进行公钥配置。我一开始失误配置成了下面的mapi网关产品密钥
,导致报错验签失败
。
接下来修改 OC
代码调用支付宝SDK支付换成打开HTML
网页,在网页里面完成支付功能。
注意后面的queryString
,由于支付网页需要UID,考虑到方便快捷,没有选择用 WebViewJSBridge
进行数据交互,而是直接拼在链接后面。
// 阿里 wap 支付
- (void)wapPay {
ZKSafariViewController *vc = [ZKSafariViewController new];
NSString *oriUrl = @"...";
NSString *queryStr = [NSString stringWithFormat:@"?uid=%@&fee=%@", _loginUser.uid, _total_fee];
NSString *urlStr = [oriUrl stringByAppendingString:queryStr];
vc.url = urlStr;
[_applicationContext.navigationController pushViewController:vc animated:YES];
}
编写HTML
页面,提交数据到PHP
后端。(前端代码)
代码如下:
<form name="alipayment" id="alipayment" action='...AliPay/CreateWapPay' method=post>
// ... 一些 input 标签,提交到服务器
</form>
<script type="text/javascript">
function GetDateNow() {
let totalFee = getQueryStringArgs().total_fee,
uid = getQueryStringArgs().uid;
// ...
document.getElementById("uid").value = uid;
document.getElementById("total_fee").value = totalFee;
// ...
}
GetDateNow();
document.forms['alipayment'].submit();
</script>
集成 支付宝 PHP SDK 详细步骤(后端代码)
- 下载PHP DEMO
- 将SDK拖入项目文件,配置
config.php
文件,如下
$config = array (
'app_id' => "...",
//商户私钥,您的原始格式RSA私钥
'merchant_private_key' => "...",
//异步通知地址
'notify_url' => "http://工程公网访问地址/alipay.trade.wap.pay-PHP-UTF-8/notify_url.php",
//同步跳转
'return_url' => "http://mitsein.com/alipay.trade.wap.pay-PHP-UTF-8/return_url.php",
//编码格式
'charset' => "UTF-8",
//签名方式
'sign_type'=>"RSA",
//支付宝网关
'gatewayUrl' => "https://openapi.alipay.com/gateway.do",
//支付宝公钥,查看地址:https://openhome.alipay.com/platform/keyManage.htm 对应APPID下的支付宝公钥。
'alipay_public_key' => "...",
);
- 组装系统参数
$sysParams
(app_id
,return_url
,nofify_url
,sign_type
等),获取业务参数$apiParams
(放在biz_content
字段中)并将其加密如下
$enCryptContent = encrypt($apiParams['biz_content'], $this->encryptKey);
$apiParams['biz_content'] = $enCryptContent;
```
将系统参数和业务参数组装在一起进行签名
```
$totalParams = array_merge($apiParams, $sysParams);
//待签名字符串
$preSignStr = $this->getSignContent($totalParams);
//签名
$totalParams["sign"] = $this->generateSign($totalParams, $this->signType);
- 然后到了关键的地方,利用
total_params
拼接表单字符串,方法如下
/**
* 建立请求,以表单HTML形式构造(默认)
* @param $para_temp 请求参数数组
* @return 提交表单HTML文本
*/
protected function buildRequestForm($para_temp) {
$sHtml = "<form id='alipaysubmit' name='alipaysubmit' action='".$this->gatewayUrl."?charset=".trim($this->postCharset)."' method='POST'>";
while (list ($key, $val) = each ($para_temp)) {
if (false === $this->checkEmpty($val)) {
//$val = $this->characet($val, $this->postCharset);
$val = str_replace("'","'",$val);
//$val = str_replace("\"",""",$val);
$sHtml.= "<input type='hidden' name='".$key."' value='".$val."'/>";
}
}
//submit按钮控件请不要含有name属性
$sHtml = $sHtml."<input type='submit' value='ok' style='display:none;''></form>";
$sHtml = $sHtml."<script>document.forms['alipaysubmit'].submit();</script>";
return $sHtml;
}
- 执行第4步生成的表单html代码被类
AlipayTradeService
进行echo
到前端页面上,包含JS自动提交脚本,所以就直接调起了支付宝支付。为了让大家更加明白,生成的h5代码形式如下:
<form id='alipaysubmit' name='alipaysubmit' action='https://openapi.alipay.com/gateway.do?charset=UTF-8' method='POST'>
<input type='hidden' name='biz_content' value='{"productCode":"QUICK_WAP_PAY","body":null,"subject":null,"out_trade_no":"1234","total_amount":"100","timeout_express":"1m"}'/>
<input type='hidden' name='app_id' value='2088711989778894'/>
<input type='hidden' name='version' value='1.0'/>
<input type='hidden' name='format' value='json'/>
<input type='hidden' name='sign_type' value='RSA'/>
<input type='hidden' name='method' value='alipay.trade.wap.pay'/>
<input type='hidden' name='timestamp' value='2017-03-20 17:16:15'/>
<input type='hidden' name='alipay_sdk' value='alipay-sdk-php-20161101'/>
<input type='hidden' name='notify_url' value='http://.../notify_url.php'/>
<input type='hidden' name='return_url' value='http://.../return_url'/>
<input type='hidden' name='charset' value='UTF-8'/>
<input type='hidden' name='sign' value='vgU9ROZeES3fa6CPo5onwY2auGN7N6naNI8Wo5l2U/K6LPk2stkv0Cor5Dn57Xo83GefOnoPg5A/7dNLbZjTXioPaocrPg3LteDB/EV3zYHXUPsab7dPztW+7guQDbLXI1RtaEuPm85hjO2Cur5EmP3P3sAE1XVGYJHHtLJoAbKzm/I='/>
<input type='submit' value='ok' style='display:none;''>
</form>
<script>document.forms['alipaysubmit'].submit();</script>"
当上面的H5代码被echo
到前端页面,会自动submit
表单信息。继续往下看
在 iOS 中实现代理进行跳转(iOS 移动端代码)
自动提交后,当手机有安装支付宝的时候,在webView
中实现一个协议方法即可自动跳转到支付宝客户端。如果没有安装,进入支付宝的H5收银台进行支付。协议方法如下
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest: (NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType
{
NSString* reqUrl = request.URL.absoluteString;
if ([reqUrl hasPrefix:@"alipays://"] || [reqUrl hasPrefix:@"alipay://"]) {
BOOL bSucc = [[UIApplication sharedApplication]openURL:request.URL];
if (!bSucc) {
// 未安装支付宝 进入网页支付
}
return NO;
}
return YES;
}
善后工作
- 当支付成功后,会自动跳转到
return_url
页面,这个页面简单展示一下支付成功信息即可。注意并不能作为交易成功的凭证。 - 支付成功后,除了会进入上面提到的
return_url
,支付宝还会异步通知notify_url
,并传递详细的交易信息,支付宝会根据上面传入的异步通知地址notify_url
通过POST
请求的形式将支付结果作为参数通知到商户后台系统。在这个接口中实现验签和支付成功的业务逻辑代码。
上面提到的常用的支付宝网站罗列一下
- 新版开发文档入口 https://openhome.alipay.com/developmentDocument.htm
- 查看是否已经签约 https://app.alipay.com/market/productIndex.htm
- 开放平台密钥管理 https://openhome.alipay.com/platform/keyManage.htm
- 调用支付宝网关接口
https://openapi.alipay.com/gateway.do
https://doc.open.alipay.com/doc2/detail.htm?treeId=203&articleId=105463&docType=1
分享几个这个项目中比较好用的函数
- 创建订单号 很简单,月日时分秒 + 5位随机数
/**
* Created by ZK on 17/3/22.
*/
// 创建订单编号
function generateOrderID(){
var formatTime = function (date) {
var month = date.getMonth() + 1,
day = date.getDate(),
hour = date.getHours(),
minute = date.getMinutes(),
second = date.getSeconds();
return [month, day,hour, minute, second].map(formatNumber).join('') ;
};
function formatNumber(n) {
n = n.toString();
return n[1] ? n : '0' + n;
}
var nowDate = new Date(),
dateStr = formatTime(nowDate),
randomNum = Math.random()*1000000000,
oriStr = dateStr + randomNum,
orderID = oriStr.substr(0,15);
return orderID;
}
- 取得 QueryString 参数值
function getQueryStringArgs() {
var qs = (location.search.length > 0 ? location.search.substring(1) : ''),
args = {},
items = qs.length ? qs.split('&') : [],
item = null,
name = null,
value = null,
i = 0,
len = items.length;
for (i = 0; i < len; i ++) {
item = items[i].split('=');
name = decodeURIComponent(item[0]);
value = decodeURIComponent(item[1]);
if (name.length) {
args[name] = value;
}
}
return args;
}
- 另外一个比较好用的在
PHP
代码中插入JS代码实现弹出debug信息,如果服务器不支持write info
,这招很方便。
echo '<script type="text/javascript">alert("testMsg");</script>';
// 输出变量内容
$name = 'dev_zk';
echo '<script type="text/javascript">alert('.$name.');</script>';
多分享几个坑
- JS 脚本中的代码最好别用
ES6
以上的版本,除非你用babel
自动转换ES5
。我就栽坑了,写的ES6脚本在iOSVersion <=9.0
的系统中全部失效报错,但是在移动应用中测试 JS 的不方便你是知道的,找了好久才意识到这个问题。高估了WebKit
对JS的版本支持更新速度。 -
ISV权限不足
--- 没有签约对应功能。 -
验签失败
--- 没有在对应APPID设置正确公钥。