支付宝

5.2 SDK集成流程

5.2.1 iOS

解压接口压缩文件(文件名称是 WS_MOBILE_PAY_SDK_BASE.zip),找到iOS的压缩文件(文件名称是支付宝移动支付SDK 标准版(iOS).zip)。

1. 导入代码

1. 步骤1:  启动IDE(如Xcode),把iOS包中的压缩文件里下面文件复制到项目目录下,

   并导入到项目project中。

2. AlipaySDK.bundle
   AlipaySDK.framework
   

   
   

3. 步骤2:  在须要调用AlipaySDK的文件里,添加头文件引用。

4. #import <AlipaySDK/AlipaySDK.h>

步骤3: 配置请求信息。

AlipaySDK.bundle
AlipaySDK.framework

Order *order = [[Order alloc] init];
order.partner = partner;
order.seller = seller;
order.tradeNO = [self generateTradeNO]; //订单ID(由商家□自□行制定)order.productName = product.subject; //商品标题order.productDescription = product.body; //商品描写叙述

order.amount = [NSString stringWithFormat:@"%.2f",product.price]; //商品价格

支付宝(中国)网络技术有限公司 版权全部|版本号:1.3第 8页

移动支付接口 SDK2.0 标准版附录文档

order.notifyURL = @"http://www.xxx.com"; //回调URLorder.service = @"mobile.securitypay.pay";order.paymentType = @"1";
order.inputCharset = @"utf-8";

order.itBPay = @"30m";

//应用注冊scheme,在AlixPayDemo-Info.plist定义URL typesNSString *appScheme = @"alisdkdemo";

//将商品信息拼接成字符串
NSString *orderSpec = [order description];NSLog(@"orderSpec = %@",orderSpec);

//获取私钥并将商户信息签名,外部商户能够依据情况存放私钥和签名,仅仅须要遵循RSA 签名规范,并将签名字符串base64 编码和 UrlEncode
id<DataSigner> signer = CreateRSADataSigner(privateKey);
NSString *signedString = [signer signString:orderSpec];

//将签名成功字符串格式化为订单字符串,请严格依照该格式NSString *orderString = nil;
if (signedString != nil) {

orderString = [NSStringstringWithFormat:@"%@&sign=\"%@\"&sign_type=\"%@\"",

                   orderSpec, signedString, @"RSA"];

[[AlipaySDK defaultService] payOrder:orderString fromScheme:appSchemecallback:^(NSDictionary *resultDic) {

          NSLog(@"reslut = %@",resultDic);

}];

[tableView deselectRowAtIndexPath:indexPath animated:YES];}

具体可參见 Demo中演示样例文件

AliSDKDemo\APViewController.hAliSDKDemo\APViewController.mAliSDKDemo\Order.h
AliSDKDemo\Order.m

步骤4: 配置支付宝client返回url处理方法。
如演示样例 AliSDKDemo\APAppDelegate.m文件里,添加引用代码:

#import <AlipaySDK/AlipaySDK.h>

支付宝(中国)网络技术有限公司 版权全部|版本号:1.3

第 9页

移动支付接口 SDK2.0 标准版附录文档

在@implementation AppDelegate中添加例如以下代码:

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)urlsourceApplication:(NSString *)sourceApplication annotation:(id)annotation{

//假设极简SDK 不可用,会跳转支付宝钱包进行支付,须要将支付宝钱包的支付结果回传给SDKif ([url.host isEqualToString:@"safepay"]) {

[[AlipaySDK defaultService] processOrderWithPaymentResult:urlstandbyCallback:^(NSDictionary *resultDic) {

          NSLog(@"result = %@",resultDic);
       }];

}

if ([url.host isEqualToString:@"platformapi"]){//支付宝钱包快登授权返回authCode

[[AlipaySDK defaultService] processAuthResult:urlstandbyCallback:^(NSDictionary *resultDic) {

          NSLog(@"result = %@",resultDic);
       }];

}

return YES;}

2. 针对Demo的执行注意

(1) 关于签名代码问题

•  AliSDKDemo\Util及以下全部文件

•  AliSDKDemo\openssl及以下全部文件

  libcrypto.a

  libssl.a

  这些文件是为演示样例签名所在client本地使用。

  出于安全考虑,请商户尽量把私钥保存在服务端,在服务端进行签名验签。

  (2) 假设遇到执行后报错,类似于下面提示信息:
  Cannot find interface declaration for 'NSObject', superclass of 'Base64'

  那么须要打开报错了的文件,添加头文件。
  

  #import <Foundation/Foundation.h>
  

(3) 假设商户要在某个文件里使用支付宝的SDK 类库,需添加引用头文件。

#import <AlipaySDK/AlipaySDK.h>

(4) 点击项目名称,点击“Build Settings”选项卡,在搜索框中,以keyword“search”搜索,对“Header Search Paths”添加头文件路径:$(SRCROOT)/项目名称。假设头文件信息已添加,可不必再添加。

支付宝(中国)网络技术有限公司 版权全部|版本号:1.3第 10页

移动支付接口 SDK2.0 标准版附录文档

图5-1添加头文件信息

(5) 点击项目名称,点击“Build Phases”选项卡,在“Link Binary with Librarles”选项中,新增“AlipaySDK.framework”和“SystemConfiguration.framework”两个系统库文件。假设商户项目中已有这两个库文件,可不必再添加。

图5-2添加系统库文件

支付宝(中国)网络技术有限公司 版权全部|版本号:1.3第 11页

移动支付接口 SDK2.0 标准版附录文档

(6) 点击项目名称,点击“Info”选项卡,在“URL Types”选项中,点击“+”,在“URL Schemes”中输入“alisdkdemo”。

“alisdkdemo”来自于文件“APViewController.m”的NSString *appScheme = @"alisdkdemo";。

图5-3配置 URL Schemes

3. 配置基本信息打开“APViewController.m”文件,对下面三个參数进行编辑

表5-1 IOS基本信息配置

NSString *partner = @"";
NSString *seller = @"";
NSString *privateKey = @"";

參数	含义
partner	合作身份者ID,以2088 开头由16 位纯数字组成的字符串。请參考“7.1怎样获得PID与密钥”。
seller	支付宝收款账号,手机号码或邮箱格式。
private_key	商户方的私钥,pkcs8格式。请參考“7.2 RSA密钥生成与使用”。

支付宝(中国)网络技术有限公司 版权全部|版本号:1.3第 12页

移动支付接口 SDK2.0 标准版附录文档注意:

这些參数配置是为client签名功能服务的,仅作为演示样例使用。

商户在接入支付宝产品时,请把这些信息通过商户项目自己的服务端传递。

4. 代码演示样例执行逻辑

1. 步骤1:  调用order.m 里的函数 description将商品信息拼接成字符串作为待签名字符串,

   如:

2. 步骤2:  使用类CreateRSADataSigner,调用signString签名函数做签名,如:

3. 步骤3:  把签名结果赋值给參数sign,并把sign 增加之前的待签名数组中,此时得到的便是要请求给支付宝的所有数据。

"partner=\"2088101568353491\"&seller_id=\"2088101568353491\"&out_trade_no=\"YR2VGG3G1I31XDZ\"&subject=\"1\"&body=\"我 是 測 试 数 据\"&total_fee=\"0.02\"&notify_url=\"http://www.xxx.com\"&service=\"mobile.securitypay.pay\"&payment_type=\"1\"&_input_charset=\"utf-8\"&it_b_pay=\"30m\"&show_url=\"m.alipay.com\""

"GsSZgPloF1vn52XAItRAldwQAbzIgkDyByCxMfTZG%2FMapRoyrNIJo4U1LUGjHp6gdBZ7U8jA1kljLPqkeGv8MZigd3kH25V0UK3Jc3C94Ngxm5S%2Fz5QsNr6wnqNY9sx%2Bw6DqNdEQnnks7PKvvU0zgsynip50lAhJmflmfHvp%2Bgk%3D"

"partner=\"2088101568353491\"&seller_id=\"2088101568353491\"&out_trade_no=\"YR2VGG3G1I31XDZ\"&subject=\"1\"&body=\"我 是 測 试 数 据\"&total_fee=\"0.02\"&notify_url=\"http://www.xxx.com\"&service=\"mobile.securitypay.pay\"&payment_type=\"1\"&_input_charset=\"utf-8\"&it_b_pay=\"30m\"&show_url=\"m.alipay.com\"&sign=\"GsSZgPloF1vn52XAItRAldwQAbzIgkDyByCxMfTZG%2FMapRoyrNIJo4U1LUGjHp6gdBZ7U8jA1kljLPqkeGv8MZigd3kH25V0UK3Jc3C94Ngxm5S%2Fz5QsNr6wnqNY9sx%2Bw6DqNdEQnnks7PKvvU0zgsynip50lAhJmflmfHvp%2Bgk%3D\"&sign_type=\"RSA\""

步骤4: 调用(AlipaySDK *)defaultService 类以下的支付接口函数,唤起支付宝支付页面。

appScheme 为app 在info.plist 注冊的 scheme。

(void)payOrder:(NSString *)orderStr
     fromScheme:(NSString *)schemeStr

       callback:(CompletionBlock)completionBlock

支付宝(中国)网络技术有限公司 版权全部|版本号:1.3第 13页

移动支付接口 SDK2.0 标准版附录文档

图5-4支付宝支付页面后面的动作全由买家在支付宝收银台中操作完毕。假设设备中有支付宝client,会

优先调用支付宝client进行支付,支付完毕后会又一次唤起商户app。

步骤5: 当这笔交易被买家支付成功后支付宝收银台上显示该笔交易成功,并提示用户“返回”。此时在APAppDelegate.m的 -

(BOOL)application:(UIApplication )application openURL:(NSURL )urlsourceApplication:(NSString *)sourceApplication annotation:(id)annotation中调用获取返回数据的代码:

拿到返回数据:
点取消后返回

对其做 URLDecode
支付宝(中国)网络技术有限公司 版权全部|版本号:1.3第 14页

[[AlipaySDK defaultService]processOrderWithPaymentResult:urlstandbyCallback:^(NSDictionary *resultDic) {NSLog(@"result = %@",resultDic);//返回的支付结果}];

"alisdkdemo://safepay/?%7B%22memo%22:%7B%22result%22:%22%22,%22memo%22:%22%E7%94%A8%E6%88%B7%E4%B8%AD%E9%80%94%E5%8F%96%E6%B6%88%22,%22ResultStatus%22:%226001%22%7D,%22requestType%22:%22safepay%22%7D"

移动支付接口 SDK2.0 标准版附录文档点确认后返回

"alisdkdemo://safepay/?

{"memo":{"result":"","memo":"用 户 中 途 取 消","ResultStatus":"6001"},"requestType":"safepay"}"

"alisdkdemo://safepay/?%7B%22memo%22:%7B%22result%22:%22partner=%5C%222088101568353491%5C%22&seller_id=%5C%222088101568353491%5C%22&out_trade_no=%5C%22QU6ZOD85K4HVQFN%5C%22&subject=%5C%221%5C%22&body=%5C%22%E6%88%91%E6%98%AF%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE%5C%22&total_fee=%5C%220.02%5C%22&notify_url=%5C%22http:%5C/%5C/www.xxx.com%5C%22&service=%5C%22mobile.securitypay.pay%5C%22&payment_type=%5C%221%5C%22&_input_charset=%5C%22utf-8%5C%22&it_b_pay=%5C%2230m%5C%22&show_url=%5C%22m.alipay.com%5C%22&success=%5C%22true%5C%22&sign_type=%5C%22RSA%5C%22&sign=%5C%22pg16DPA%5C/cIRg1iUFCl8lYZG54de+kfw+vCj32hGWye97isZ1A4bW6RNaDXHhZXVaI5Vk2YDxhNUl85EHRd+EL7%5C/+ogQTnsaEHl+D13PuZExIXRKGBnkYqaNV6kH6hDygnf5IOtoojHWLQyem7oRBVzB0vlF%5C/+YGFpzFHZyTVpM8=%5C%22%22,%22memo%22:%22%22,%22ResultStatus%22:%229000%22%7D,%22requestType%22:%22safepay%22%7D"

对其做 URLDecode

"alisdkdemo://safepay/?{"memo":{"result":"partner=\"2088101568353491\"&seller_id=\"2088101568353491\"&out_trade_no=\"QU6ZOD85K4HVQFN\"&subject=\"1\"&body=\"我 是 測 试 数 据\"&total_fee=\"0.02\"&notify_url=\"http:\/\/www.xxx.com\"&service=\"mobile.securitypay.pay\"&payment_type=\"1\"&_input_charset=\"utf-8\"&it_b_pay=\"30m\"&show_url=\"m.alipay.com\"&success=\"true\"&sign_type=\"RSA\"&sign=\"pg16DPA\/cIRg1iUFCl8lYZG54de+kfw+vCj32hGWye97isZ1A4bW6RNaDXHhZXVaI5Vk2YDxhNUl85EHRd+EL7\/+ogQTnsaEHl+D13PuZExIXRKGBnkYqaNV6kH6hDygnf5IOtoojHWLQyem7oRBVzB0vlF\/+YGFpzFHZyTVpM8=\"","memo":"","ResultStatus":"9000"},"requestType":"safepay"}"

之后,对这些数据做处理。

注意:

•  因为在跳转支付宝client支付的过程中,商户app在后台非常可能被系统kill了,所以pay 接口的callback 就会失效,请商户对 standbyCallback返回的回调结果进行处理;

•  同步返回数据时,建议通过服务端的验签功能代码做验签处理,之后再对返回的数据做业务逻辑处理;

•  须以server异步通知的结果数据为准,并对其做业务逻辑处理。

•