Ping++ SDK
1.简介
Ping++ SDK包括Server和Client两部分。
其中Server目前支持 PHP，Java，Python，Node.js，Ruby，Go，C# 七种语言。
Client目前支持 iOS终端，Android终端，手机网页和PC网页这四种平台，分别对应iOS，Android，HTML5和PC这四种Client SDK。
2.环境
为了提高接入效率，Ping++提供了Live和Test两个工作模式提供开发者接入时使用，这两种模式切换非常简单，只需要在使用Server SDK 的过程中设置 API Key 时根据自己的需要使用相应的Key即可，设置为test key 表明使用Test 模式，设置为live key 则使用Live模式。Test Key 在你注册Ping++后即可自动获得，Live key 则是在你完成签约后获得。
1??Test 模式
Test模式提供开发测试时使用。因为Test模式吧支付流程与渠道草书隔离开，所以开发可以与渠道申请同时进行，从而缩短接入调试时间，Test 模式中发起虚拟交易不会调用真实支付控件，支付时客户端会调转到Ping++提供的支付页面
2??Live 模式
Live 时应用上线的模式。该模式下会发生真实的交易，调起真实的支付控件产生真实的资金流动，所以请确保在Test模式下所有的攻能逗测试通过后，在切换到Live模式。
3.参数
应用在接入 Ping++ SDK 时，需要使用以下三个参数，这三个参数你可以在管理平台中获取：
1??API Key：是 Ping++ 分配给你的唯一身份标识，即上面说到的Test Key 和 Live Key。
2??应用ID：是 Ping++ 分配给你的应用的唯一标识。
3??Notify URL：是 Ping++ 系统用来向你的应用后台推送异步通知时使用的地址，该地址必须是一个互联网可以访问的地址。你可以在 Ping++ 管理平台中对应的应用内进行设置。
下面介绍下Ping++如何发起并完成支付
1. Client 发送支付要素给 Server
用户选择渠道点击交易按钮， Client 收集交易所需的相关参数传递给 Server （服务器的地址为代码中的 URL）
NSMutableURLRequest * postRequest=[NSMutableURLRequest requestWithURL:url];
NSDictionary* dict = @{
@"channel" : self.channel,
@"amount" : amountStr
};
[postRequest setHTTPMethod:@"POST"];
[postRequest setValue:@"application/json; charset=utf-8" forHTTPHeaderField:@"Content-Type"];
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])]];
ViewController * __weak weakSelf = self;
NSOperationQueue *queue = [[NSOperationQueue alloc] init];
[self showAlertWait];
[NSURLConnection sendAsynchronousRequest:postRequest queue:queue completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
dispatch_async(dispatch_get_main_queue(), ^{
NSHTTPURLResponse* httpResponse = (NSHTTPURLResponse*)response;
[weakSelf hideAlert];
if (httpResponse.statusCode != 200) {
NSLog(@"statusCode=%ld error = %@", (long)httpResponse.statusCode, connectionError);
[weakSelf showAlertMessage:kErrorNet];
return;
}
if (connectionError != nil) {
NSLog(@"error = %@", connectionError);
[weakSelf showAlertMessage:kErrorNet];
return;
}
NSString* charge = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
NSLog(@"charge = %@", charge);
//客户端从服务器端拿到charge对象后，调用下面的方法
//请看3.Client 调起支付控件完成支付
});
}];
2. Server 发送支付请求并将返回的支付凭据传给 Client
Server 接收并处理 Client 传过来的数据，使用 Ping++ 提供的方法向 Ping++ 发起交易，并将从 Ping++ 获得的带支付凭据的 Charge 对象返回给 Client。
3. Client 调起支付控件完成支付
Client 接收 Server 返回的带支付凭据的 Charge 对象并用之调起支付插件完成交易.
//客户端从服务器端拿到charge对象后，调用下面的方法
[Pingpp createPayment:charge viewController:weakSelf appURLScheme:kUrlScheme withCompletion:^(NSString *result, PingppError *error) {
NSLog(@"completion block: %@", result);
if (error == nil) {
NSLog(@"支付成功");
} else {
NSLog(@"PingppError: code=%lu msg=%@", (unsigned long)error.code, [error getMsg]);
NSLog(@"支付失败");
}
[weakSelf showAlertMessage:result];
}];
4. 渠道同步返回支付结果给 Client
在上一步中用户完成了支付，渠道会返回一个支付结果给客户端，这里 Client 需要做的是处理此结果。
渠道为银联、百度钱包或者渠道为支付宝但未安装支付宝钱包时，交易结果会在调起插件时的 Completion 中返回。 渠道为微信、支付宝且安装了支付宝钱包时，请实现 UIApplicationDelegate 的 - application:openURL:sourceApplication:annotation: 方法：
#warning 渠道为微信、支付宝且安装了支付宝钱包时实现方法
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options{
[Pingpp handleOpenURL:[NSURL URLWithString:kUrl] 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 文档。
参考链接： https://www.pingxx.com/guidance/client/sdk/ios