ios的Ping++支付接入步骤
Ping++ SDK 包括 Server 和 Client 两部分。
其中 Server SDK 提供了
PHP
,Java
,Python
,Node.js
,Ruby
,Go
六种语言版本。Client SDK 提供了
Android
,iOS
,HTML5
三种平台版本。
应用在接入 Ping++ SDK 时,需要使用以下三个参数,这三个参数你可以在管理平台中获取:
API Key:API Key 是 Ping++ 分配给你的唯一身份标识。在 Server SDK 的使用过程中需要配置该参数。注册 Ping++ 账号并通过审核后,Ping++ 会分配给你两个 API Key,分别为:
Test Key
和Live Key
。Test Key
和Live Key
分别表明使用测试模式和真实模式,你可以根据实际应用使用场景分别使用。应用 ID:应用 ID 是 Ping++ 分配给你的应用的唯一标识。在 Server SDK 的使用过程中需要配置该参数。
Notify URL:Notify URL 是 Ping++ 系统用来向你的应用后台推送异步通知时使用的地址,该地址必须是一个互联网可以访问的地址。你可以在 Ping++ 管理平台中对应的应用内进行设置。
一、接入步骤:
获取 SDK
从 Github 下载 SDK, 里面包含了 lib 文件夹和 example 文件夹。lib 文件夹里面是 SDK 的文件,example 文件夹里是接入示例代码
依赖 Frameworks:
必需:CFNetwork.frameworkSystemConfiguration.frameworkSecurity.frameworklibc++.dylib
百度钱包所需:
libz.dyliblibstdc++.dylibCoreTelephony.frameworkAddressBook.frameworkAddressBookUI.frameworkAudioToolbox.frameworkCoreAudio.frameworkCoreGraphics.frameworkImageIO.frameworkMapKit.frameworkMessageUI.frameworkMobileCoreServices.frameworkQuartzCore.framework
根据所需渠道导入相应的库文件
添加 URL Schemes:在 Xcode 中,选择你的工程设置项,选中 "TARGETS" 一栏,在 "Info" 标签栏的 "URL Types" 添加 "URL Schemes",如果使用微信,填入所注册的应用程序 id,如果不使用微信,则自定义,建议起名稍复杂一些,尽量避免与其他程序冲突。
添加 Other Linker Flags:在 Build Settings 搜索 Other Linker Flags ,添加
-ObjC
。
二、发起支付:
1. Client 发送支付要素给 Server
用户选择渠道点击交易按钮, Client 收集交易所需的相关参数传递给 Server (服务器的地址为代码中的 URL)。
NSDictionary* dict = @{ @"channel" : channel, // 渠道 alipay, wx, upacp, bfb @"amount" : amount // 金额};NSData* data = [NSJSONSerialization dataWithJSONObject:dict options:NSJSONWritingPrettyPrinted error:nil];NSString *bodyData = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]; [postRequest setHTTPBody:[NSData dataWithBytes:[bodyData UTF8String] length:strlen([bodyData UTF8String])]]; [postRequest setHTTPMethod:@"POST"]; [postRequest setValue:@"application/json; charset=utf-8" forHTTPHeaderField:@"Content-Type"]; NSOperationQueue *queue = [[NSOperationQueue alloc] init]; [NSURLConnection sendAsynchronousRequest:postRequest queue:queue completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) { NSHTTPURLResponse* httpResponse = (NSHTTPURLResponse*)response; NSString* charge = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]; // ...}];
2. Server 发送支付请求并将返回的支付凭据传给 Client
Server 接收并处理 Client 传过来的数据,使用 Ping++ 提供的方法向 Ping++ 发起交易,并将从 Ping++ 获得的带支付凭据的 Charge 对象返回给 Client。
<?php//引用 SDK 库文件require_once(‘/path/to/Pingpp.php‘);//获取客户端的参数,这里不能使用 $_POST 接收,所以我们提供了如下的参考方法接收$input_data = json_decode(file_get_contents("php://input"), true);//TODO 客户在这里自行处理接收过来的交易所需的数据//设置API KEY,如果是测试模式,这里填入 Test Key;如果是真实模式, 这里填入 Live Key。Pingpp::setApiKey("YOUR-KEY");//创建支付对象,发起交易$ch = Pingpp_Charge::create( //array 里需要哪些参数请阅读 API Reference 文档 array( "order_no" => $orderNo, //商户系统自己生成的订单号 "app" => array("id" => "YOUR-APP-ID"), //Ping++ 分配给商户的应用 ID "amount" => $amount, //交易金额 "channel" => $channel, //交易渠道 "currency" => "cny", "client_ip" => $_SERVER["REMOTE_ADDR"], //发起交易的客户端的 IP "subject" => "Your Subject", "body" => "Your Body", "extra" => null //仅客户端为 HTML5 时此参数不为空,具体请参考 API Reference 文档 ) );echo $ch;
3. Client 调起支付控件完成支付
Client 接收 Server 返回的带支付凭据的 Charge 对象并用之调起支付插件完成交易
[Pingpp createPayment:charge viewController:viewController appURLScheme:kUrlScheme withCompletion:^(NSString *result, PingppError *error) { if ([result isEqualToString:@"success"]) { // ... } else { NSLog(@"PingppError: code=%lu msg=%@", error.code, [error getMsg]); } }];
4. 渠道同步返回支付结果给 Client
在上一步中用户完成了支付,渠道会返回一个支付结果给客户端,这里 Client 需要做的是处理此结果。
渠道为银联、百度钱包或者渠道为支付宝但未安装支付宝钱包时,交易结果会在调起插件时的 Completion 中返回。 渠道为微信、支付宝且安装了支付宝钱包时,请实现 UIApplicationDelegate
的 - application:openURL:sourceApplication:annotation:
方法:
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation { [Pingpp handleOpenURL:url withCompletion:^(NSString *result, PingppError *error) { if ([result isEqualToString:@"success"]) { // ... } else { NSLog(@"PingppError: code=%lu msg=%@", error.code, [error getMsg]); } }]; return YES; }
5. Server 收到 Ping++ 发送的交易结果的异步通知
Ping++ 会把从渠道收到的异步通知告诉商户 Server,客户 Server 接收到异步通知是一个带支付状态的完整的 Charge 对象,客户在接收到异步通知后需要回复 success 给 Ping++ 表明成功收到异步通知。所有的交易结果,商户均须以异步通知结果为准。关于异步通知具体请参见 API Reference 文档。
<?php$input_data = json_decode(file_get_contents("php://input"), true);if($input_data[‘object‘] == ‘charge‘) { //TODO update database echo ‘success‘; } else { echo ‘fail‘; }
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。