支付宝 手机网页支付转Native遇到的一小坑
iOS接入说明
配置
步骤1:启动IDE(如Xcode),把iOS包中的压缩文件中以下文件拷贝到项目文件夹下,并导入到项目工程中。
AlipaySDK.bundle
AlipaySDK.framework
在Build Phases选项卡的Link Binary With Libraries中,增加以下依赖:
其中,需要注意的是:
- 如果是Xcode 7.0之后的版本,需要添加libc++.tbd、libz.tbd;
- 如果是Xcode 7.0之前的版本,需要添加libc++.dylib、libz.dylib(如下图)。
步骤2:在需要调用AlipaySDK的文件中,增加头文件引用。
#import <AlipaySDK/AlipaySDK.h>
步骤3:配置支付宝客户端返回url处理方法。
(外部存在支付包钱包,支付宝钱包将处理结果通过url返回。)
如示例AliSDKDemo\APAppDelegate.m文件中,增加引用代码:
#import <AlipaySDK/AlipaySDK.h>
在@implementation AppDelegate中增加如下代码:
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
//如果极简开发包不可用,会跳转支付宝钱包进行支付,需要将支付宝钱包的支付结果回传给开发包
if ([url.host isEqualToString:@"safepay"]) {
[[AlipaySDK defaultService] processOrderWithPaymentResult:url standbyCallback:^(NSDictionary *resultDic) {
//【由于在跳转支付宝客户端支付的过程中,商户app在后台很可能被系统kill了,所以pay接口的callback就会失效,请商户对standbyCallback返回的回调结果进行处理,就是在这个方法里面处理跟callback一样的逻辑】
NSLog(@"result = %@",resultDic);
}];
}
if ([url.host isEqualToString:@"platformapi"]){//支付宝钱包快登授权返回authCode
[[AlipaySDK defaultService] processAuthResult:url standbyCallback:^(NSDictionary *resultDic) {
//【由于在跳转支付宝客户端支付的过程中,商户app在后台很可能被系统kill了,所以pay接口的callback就会失效,请商户对standbyCallback返回的回调结果进行处理,就是在这个方法里面处理跟callback一样的逻辑】
NSLog(@"result = %@",resultDic);
}];
}
return YES;
}
接口调用说明
本SDK提供的所有接口均定义在AlipaySDK.h中。
SDK中提供了若干接口,手机网站转Native支付只用到其中一部分,本文未提到的接口无需关注。
如何调用提供的接口?
APP支付最新版本 15.4.0 新增拦截+支付二合一接口(payInterceptorWithUrl...),该接口将原来的获取H5支付订单信息接口和支付接口进行了合并。
接口的调用方式是先调用defaultService获取SDK的实例,然后再调用单独提供的功能接口,以payInterceptorWithUrl为例:
[[AlipaySDK defaultService] payInterceptorWithUrl:url fromScheme:scheme callback:^(NSDictionary *result) {
// 处理支付结果
NSLog(@"%@", result);
}];
如何实现手机网站转APP支付?
步骤一: 实现UIWebViewDelegate协议,拦截H5的URL;
步骤二: 调用新增拦截+支付二合一接口(payInterceptorWithUrl...)进行URL拦截及支付转化;具体参照如下接口说明。
拦截+支付二合一接口
接口原型
/**
* 支付宝H5支付URL拦截器,完成拦截及支付方式转化
*
* @param urlStr 待过滤拦截的 url string
* @param schemeStr 调用支付的app注册在info.plist中的scheme
* @param compltionBlock 支付结果回调Block
*
* @return YES:表示URL为支付宝支付URL,URL已经被拦截转化;NO:表示URL非支付宝支付URL;
*/
- (BOOL)payInterceptorWithUrl:(NSString *)urlStr
fromScheme:(NSString *)schemeStr
callback:(CompletionBlock)completionBlock;
接口功能
本接口首先是个拦截器,拦截支付宝H5支付URL;其次是个支付方式转化器,将手机网站支付方式转化为APP支付方式。
参数说明
参数名称 | 类型 | 说明 |
---|---|---|
urlStr | NSString * | 手机网站支付的请求URL |
schemeStr | NSString * | 接入方App注册的URL scheme,供支付完成后跳回接入方App |
completionBlock | objc(^CompletionBlock)(NSDictionary *resultDic) | 支付结束之后的回调其中CompletionBlock定义如下:objctypedef void(^CompletionBlock)(NSDictionary \*resultDic);
|
同步拦截结果返回值说明
返回值类型 | 说明 |
---|---|
BOOL | 1.如果urlStr是有效的支付宝H5支付URL,则说明拦截转化成功,返回YES,商户容器无需再加载该URL; 2.如果是无效的,则返回NO,商户容器需要继续加载该URL。 |
异步支付结果返回值说明
支付结束后SDK将回调completionBlock,并将支付结果resultDic(NSDictionary *类型)作为参数传入该Block。resultDic中主要包含两个字段,如下所示:
参数名称 | 类型 | 说明 |
---|---|---|
resultCode | NSString * | 返回码,标识支付状态,含义如下: 9000——订单支付成功 8000——正在处理中 4000——订单支付失败 5000——重复请求 6001——用户中途取消 6002——网络连接出错 |
returnUrl | NSString * | 支付结束后应当跳转的url地址 |
接口使用方式
调用本接口对支付宝支付URL进行拦截和支付转化。
当接口调用完成后,该接口会返回一个BOOL类型的同步拦截结果,如果同步结果返回值为YES,说明传入的URL为支付宝支付URL,支付宝SDK已经成功拦截该URL,并转化为APP支付方式,商户容器无需再加载该URL;如果返回值为NO,说明传入的URL并非支付宝支付URL,商户容器需要继续加载该URL;
当支付结束后,会通过回调的方式返回异步支付结果,如果返回的支付结果中的resultCode为9000,则表示支付成功,接入方可以提示用户支付成功;如果返回结果不是9000,无需做任何处理。当返回的returnUrl不为空,建议接入方跳转到该returnUrl。
- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType
{
__weak APWebViewController* wself = self;
BOOL isIntercepted = [[AlipaySDK defaultService] payInterceptorWithUrl:[request.URL absoluteString] fromScheme:@"alisdkdemo" callback:^(NSDictionary *result) {
// 处理支付结果
NSLog(@"%@", result);
// isProcessUrlPay 代表 支付宝已经处理该URL
if ([result[@"isProcessUrlPay"] boolValue]) {
// returnUrl 代表 第三方App需要跳转的成功页URL
NSString* urlStr = result[@"returnUrl"];
[wself loadWithUrlStr:urlStr];
}
}];
if (isIntercepted) {
return NO;
}
return YES;
}
拦截H5的支付链接,调用 payInterceptorWithUrl结果死活调不起来支付宝客户端,苦苦寻觅半天发现不能直接传H5链接,要传 mclient 开头的链接,或者不做限制直接调用接口,总感觉这样直接拦截不合适。