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';
}