概述
iOS支付宝支付集成
详细
支付宝和微信都是业界的老大哥,相信大家都有所觉得文档、SDK都是各种坑吧(纯粹吐槽而已),本文先整理支付宝支付集成。
一、准备工作
1、向支付宝”签约" 成为支付宝的”商户”, 签约完成后, 支付宝会提供一些必要的数据给我们(商户ID-partner,帐号ID-支付宝帐号)
注意:签约成为支付宝商户,需要提供公司营业执照[http://act.life.alipay.com/shopping/before/help/index.html](http://act.life.alipay.com/shopping/before/help/index.html)
2、获取支付相关的 '私钥' 和 '密钥'
[https://doc.open.alipay.com/doc2/detail?treeId=44&articleId=103242&docType=1](https://doc.open.alipay.com/doc2/detail?treeId=44&articleId=103242&docType=1)
3、下载支付的SDK
[https://doc.open.alipay.com/doc2/detail?treeId=54&articleId=103419&docType=1](https://doc.open.alipay.com/doc2/detail?treeId=54&articleId=103419&docType=1)
二、集成支付宝SDK步骤
1、从官方Demo中把红色标注的文件添加进入项目中,记得选copy;
2、
点击项目名称,点击“Build Phases”选项卡,在“Link Binary with Librarles” 选项中,新增“AlipaySDK.framework”和“SystemConfiguration.framework” 两个系统库文件。如果项目中已有这两个库文件,可不必再增加;
添加下图中的库:
localhost:alipay mac$ ls
APAuthV2Info.h Order.h libssl.a
APAuthV2Info.m Order.m openssl
AlipaySDK.bundle Util
AlipaySDK.framework libcrypto.a
导入系统库
SystemConfiguration.framework
3、
添加Pch文件新建pch成功后,在pch文件中添加#import然后按照下图所示,进行修改pch的文件路径
也可以不设置,我这个是我需要设置#import <UIKit/UIKit.h> #import <Foundation/Foundation.h>,也可以不用使用,只在当前文件里添加相对应的使用即可,但是这样针对整个项目来说方便些
4、
修改SDK路径完成以上两步之后,会发现出现了一个经典的错误,找不到:#include解决这个问题,需要在Header Search Path中配置SDK中的点a(libssl.a/libcrypto.a)文件所在的路径,找到之后设置好正确的路径
点击项目名称,点击“Build Settings”选项卡,在搜索框中,以关键字“search” 搜索,对“Header Search Paths”增加头文件路径:“$(SRCROOT)/项目名称/IntegratedAlipay/AlipayFiles”(注意:不包括引号,如果不是放到项目根目录下,请在项目名称后面加上相应的目录名);
根据你文件位置,我的是:
“$(SRCROOT)/QTXStudent/Classes/Alipay/AlipayFiles”
5、 为URL Types 添加支付宝回调scheme
点击项目名称,点击“Info”选项卡,在URL types里面添加一项,Identifier可以不填,URL schemes必须和appScheme的值相同,用于支付宝处理回到应用的事件;
为URL Types 添加支付宝回调scheme
6、在工程项目的plist文件中添加
iOS 9以后的系统需要添加支付宝分享的scheme到白名单中,scheme名为alipayshare
按如下形式添加即可:
7、在AppDelegate中处理事件回调:
/**
这里处理微信/支付宝支付完成之后跳转回来
*/
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
//如果极简 SDK 不可用,会跳转支付宝钱包进行支付,需要将支付宝钱包的支付结果回传给 SDK
if ([url.host isEqualToString:@"safepay"]) {
//跳转支付宝钱包进行支付,处理支付结果
[[AlipaySDK defaultService] processOrderWithPaymentResult:url standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"支付宝客户端支付结果result = %@",resultDic);
if (resultDic && [resultDic objectForKey:@"resultStatus"] && ([[resultDic objectForKey:@"resultStatus"] intValue] == 9000)) {
// 发通知带出支付成功结果
[[NSNotificationCenter defaultCenter] postNotificationName:ZLAliReturnSucceedPayNotification object:resultDic];
} else {
// 发通知带出支付失败结果
[[NSNotificationCenter defaultCenter] postNotificationName:ZLAliReturnFailedPayNotification object:resultDic];
}
}];
}
if ([url.host isEqualToString:@"platformapi"]){//支付宝钱包快登授权返回 authCode
[[AlipaySDK defaultService] processAuthResult:url standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"支付宝网页版result = %@",resultDic);
if (resultDic && [resultDic objectForKey:@"resultStatus"] && ([[resultDic objectForKey:@"resultStatus"] intValue] == 9000)) {
// 发通知带出支付成功结果
[[NSNotificationCenter defaultCenter] postNotificationName:ZLAliReturnSucceedPayNotification object:resultDic];
} else {
// 发通知带出支付失败结果
[[NSNotificationCenter defaultCenter] postNotificationName:ZLAliReturnFailedPayNotification object:resultDic];
}
}];
}
return YES;
}
// NOTE: 9.0以后使用新API接口
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options
{
//如果极简 SDK 不可用,会跳转支付宝钱包进行支付,需要将支付宝钱包的支付结果回传给 SDK
if ([url.host isEqualToString:@"safepay"]) {
//跳转支付宝钱包进行支付,处理支付结果
[[AlipaySDK defaultService] processOrderWithPaymentResult:url standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"支付宝客户端支付结果result = %@",resultDic);
if (resultDic && [resultDic objectForKey:@"resultStatus"] && ([[resultDic objectForKey:@"resultStatus"] intValue] == 9000)) {
// 发通知带出支付成功结果
[[NSNotificationCenter defaultCenter] postNotificationName:ZLAliReturnSucceedPayNotification object:resultDic];
} else {
// 发通知带出支付失败结果
[[NSNotificationCenter defaultCenter] postNotificationName:ZLAliReturnFailedPayNotification object:resultDic];
}
}];
}
if ([url.host isEqualToString:@"platformapi"]){//支付宝钱包快登授权返回 authCode
[[AlipaySDK defaultService] processAuthResult:url standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"支付宝网页版result = %@",resultDic);
if (resultDic && [resultDic objectForKey:@"resultStatus"] && ([[resultDic objectForKey:@"resultStatus"] intValue] == 9000)) {
// 发通知带出支付成功结果
[[NSNotificationCenter defaultCenter] postNotificationName:ZLAliReturnSucceedPayNotification object:resultDic];
} else {
// 发通知带出支付失败结果
[[NSNotificationCenter defaultCenter] postNotificationName:ZLAliReturnFailedPayNotification object:resultDic];
}
}];
}
return YES;
}
8、 在需要用的地方导入“AlipayHeader.h”,并使用“[AlipayRequestConfig alipayWithPartner:...”方法进行支付;
/**
* 配置请求信息,仅有变化且必要的参数
*
* @param partner 合作者身份ID 以 2088 开头由 16 位纯数字组成的字符串。
* @param sellerID 卖家支付宝账号 以 2088 开头由 16 位纯数字组成的字符串。
* @param outTradeNO 商户网站唯一订单号
* @param subject 商品名称
* @param body 商品详情
* @param totalFee 总金额
* @param notifyURL 服务器异步通知页面路径
* @param itBPay 未付款交易的超时时间
*/
+ (void)alipayWithPartner:(NSString *)partner
sellerID:(NSString *)sellerID
outTradeNO:(NSString *)outTradeNO
subject:(NSString *)subject
body:(NSString *)body
totalFee:(NSString *)totalFee
notifyURL:(NSString *)notifyURL;
仅含有变化的参数:
+ (void)alipayWithPartner:(NSString *)partner
sellerID:(NSString *)sellerID
outTradeNO:(NSString *)outTradeNO
subject:(NSString *)subject
body:(NSString *)body
totalFee:(NSString *)totalFee
notifyURL:(NSString *)notifyURL {
[self alipayWithPartner:partner sellerID:sellerID outTradeNO:outTradeNO subject:subject body:body totalFee:totalFee notifyURL:aliNotifyURL service:@"mobile.securitypay.pay" paymentType:@"1" inputCharset:@"utf-8" itBPay:@"30m" privateKey:aliPrivateKey appScheme:aliAppScheme];
}
包含所有必要的参数:
+ (void)alipayWithPartner:(NSString *)partner
sellerID:(NSString *)sellerID
outTradeNO:(NSString *)outTradeNO
subject:(NSString *)subject
body:(NSString *)body
totalFee:(NSString *)totalFee
notifyURL:(NSString *)notifyURL
service:(NSString *)service
paymentType:(NSString *)paymentType
inputCharset:(NSString *)inputCharset
itBPay:(NSString *)itBPay
privateKey:(NSString *)privateKey
appScheme:(NSString *)appScheme {
Order *order = [Order order];
order.partner = partner;
order.sellerID = sellerID;
order.outTradeNO = outTradeNO;
order.subject = subject;
order.body = body;
order.totalFee = totalFee;
order.notifyURL = notifyURL;
order.service = service;
order.paymentType = paymentType;
order.inputCharset = inputCharset;
order.itBPay = itBPay;
// 将商品信息拼接成字符串
NSString *orderSpec = [order description];
// 获取私钥并将商户信息签名,外部商户可以根据情况存放私钥和签名,只需要遵循 RSA 签名规范, 并将签名字符串 base64 编码和 UrlEncode
NSString *signedString = [self genSignedStringWithPrivateKey:aliPrivateKey OrderSpec:orderSpec];
// 调用支付接口
[self payWithAppScheme:appScheme orderSpec:orderSpec signedString:signedString];
}
生成signedString:
+ (NSString *)genSignedStringWithPrivateKey:(NSString *)privateKey OrderSpec:(NSString *)orderSpec {
// 获取私钥并将商户信息签名,外部商户可以根据情况存放私钥和签名,只需要遵循 RSA 签名规范, 并将签名字符串 base64 编码和 UrlEncode
id<DataSigner> signer = CreateRSADataSigner(privateKey);
return [signer signString:orderSpec];
}
支付:
+ (void)payWithAppScheme:(NSString *)appScheme orderSpec:(NSString *)orderSpec signedString:(NSString *)signedString {
// 将签名成功字符串格式化为订单字符串,请严格按照该格式
NSString *orderString = nil;
if (signedString != nil) {
orderString = [NSString stringWithFormat:@"%@&sign=\"%@\"&sign_type=\"%@\"", orderSpec, signedString, @"RSA"];
[[AlipaySDK defaultService] payOrder:orderString fromScheme:appScheme callback:^(NSDictionary *resultDic) { // 网页版
NSLog(@"支付宝支付结果 reslut = %@", resultDic);
// 返回结果需要通过 resultStatus 以及 result 字段的值来综合判断并确定支付结果。 在 resultStatus=9000,并且 success="true"以及 sign="xxx"校验通过的情况下,证明支付成功。其它情况归为失败。较低安全级别的场合,也可以只通过检查 resultStatus 以及 success="true"来判定支付结果
if (resultDic && [resultDic objectForKey:@"resultStatus"] && ([[resultDic objectForKey:@"resultStatus"] intValue] == 9000)) {
// 发通知带出支付成功结果
[ZLNotificationCenter postNotificationName:QTXAliReturnSucceedPayNotification object:resultDic];
} else {
// 发通知带出支付失败结果
[ZLNotificationCenter postNotificationName:QTXAliReturnFailedPayNotification object:resultDic];
}
}];
}
}
9、
在本头文件中设置aliPartnerID、aliSellerAccount、aliNotifyURL、aliAppScheme和aliPrivateKey的值(所有的值在支付宝回复的邮件里面:注意,建议除appScheme以外的字段都从服务器请求);
这时候,我们支付就直接一句话搞定:
// 支付宝支付
[AlipayRequestConfig alipayWithPartner:aliPartnerID sellerID:aliSellerAccount outTradeNO:[self generateTradeNO] subject:@"测试" body:@"支付宝支付" totalFee:@"0.01" notifyURL:aliNotifyURL]; // notifyURL: 回调url@"http://www.xxx.com"
[ZLNotificationCenter addObserver:self selector:@selector(paySucceed) name:ZLAliReturnSucceedPayNotification object:nil];
[ZLNotificationCenter addObserver:self selector:@selector(payFailed) name:ZLAliReturnFailedPayNotification object:nil];
10、建议除appScheme以外的字段都从服务器请求!
建议除appScheme以外的字段都从服务器请求!建议除appScheme以外的字段都从服务器请求!
PS:重要的事情说三遍!!!
上面的第七步和第八步建议不要使用,直接用第九步去替代!建议除appScheme以外的字段都从服务器请求!
如果后台给你一个接口返回那些参数了,你就不用客户端去加密算法,只负责请求后台拿到这些参数再去请求支付宝即可.
下面例子是支付宝的拼接方式,请按照当前版本的相对应的拼接方式来.
// 支付宝支付
- (void)alipayPay {
NSMutableDictionary *params = [NSMutableDictionary dictionary];
params[@"orderNo"] = self.orderNo; // 订单号
params[@"realAmt"] = [NSString stringWithFormat:@"%.2lf", self.realAmt]; // 金额
__weak __typeof(self) weakSelf = self;
[QTXHttpTool post:QTX_aliPay_url params:params success:^(id json) {
QTXLog(@"支付宝支付返回参数接口 请求成功-%@", json);
if ([json[@"success"] isEqual:@(YES)]) {
// 返回生成订单信息及签名
NSString *signedString = json[@"data"][@"sign"];
NSString *orderInfoEncoded = json[@"data"][@"orderInfo"];
// NOTE: 如果加签成功,则继续执行支付
if (signedString != nil) {
// NOTE: 将签名成功字符串格式化为订单字符串,请严格按照该格式
// NSString *orderString = [NSString stringWithFormat:@"%@&sign=%@&sign_type=RSA", orderInfoEncoded, signedString];
NSString *orderString = [NSString stringWithFormat:@"%@&sign=\"%@\"&sign_type=\"%@\"",
orderInfoEncoded, signedString, @"RSA"];
// NOTE: 调用支付结果开始支付
[[AlipaySDK defaultService] payOrder:orderString fromScheme:XHHAppScheme callback:^(NSDictionary *resultDic) {
QTXLog(@"reslut = %@",resultDic);
if ([resultDic[@"resultStatus"] intValue] == 9000) {
[QTXNotificationCenter addObserver:self selector:@selector(paySucceed) name:QTXWXReturnSucceedPayNotification object:nil];
} else {
[QTXNotificationCenter addObserver:self selector:@selector(payFailed) name:QTXWXReturnFailedPayNotification object:nil];
}
}];
}
} else {
[MBProgressHUD showError:[NSString stringWithFormat:@"%@", json[@"errorMessage"]]];
}
} failure:^(NSError *error) {
[MBProgressHUD showError:@"暂无网络,稍后再试"];
QTXLog(@"支付宝支付返回参数接口 请求失败-%@", error);
}];
}
11、支付宝集成失败相关问题
1. 报错 AL159
查看金额是否是两位小数,切不可拼接"元"
2. 报错“创建交易异常,请重新创建后再付款”
返回的状态码是“6001”,取消支付
当是用公司注册支付宝App时分配的商户账号登陆的支付宝,进行支付测试的。支付宝那边检测到是商户而不是普通的支付账号,商户支付给商户自己,所以支付失败!
三、其他补充
1、压缩文件截图
2、Alipay 包截图
目前是项目中直接操作, 在AlipayHeader.h文件里补充上你们项目的aliPartnerID, aliSellerAccount, aliNotifyURL, 具体可参考代码, 项目则能够直接运行!