ios的Ping++支付接入步骤

Ping++ SDK 包括 Server 和 Client 两部分。

  • 其中 Server SDK 提供了 PHP, Java, Python, Node.js, Ruby, Go 六种语言版本。

  • Client SDK 提供了 Android, iOS, HTML5 三种平台版本。

应用在接入 Ping++ SDK 时,需要使用以下三个参数,这三个参数你可以在管理平台中获取:

  1. API Key:API Key 是 Ping++ 分配给你的唯一身份标识。在 Server SDK 的使用过程中需要配置该参数。注册 Ping++ 账号并通过审核后,Ping++ 会分配给你两个 API Key,分别为:Test KeyLive KeyTest KeyLive Key 分别表明使用测试模式和真实模式,你可以根据实际应用使用场景分别使用。

  2. 应用 ID:应用 ID 是 Ping++ 分配给你的应用的唯一标识。在 Server SDK 的使用过程中需要配置该参数。

  3. Notify URL:Notify URL 是 Ping++ 系统用来向你的应用后台推送异步通知时使用的地址,该地址必须是一个互联网可以访问的地址。你可以在 Ping++ 管理平台中对应的应用内进行设置。

一、接入步骤:

  1. 获取 SDK

    Github 下载 SDK, 里面包含了 lib 文件夹和 example 文件夹。lib 文件夹里面是 SDK 的文件,example 文件夹里是接入示例代码

  2. 依赖 Frameworks:
               必需:

    CFNetwork.frameworkSystemConfiguration.frameworkSecurity.frameworklibc++.dylib

               百度钱包所需:

    libz.dyliblibstdc++.dylibCoreTelephony.frameworkAddressBook.frameworkAddressBookUI.frameworkAudioToolbox.frameworkCoreAudio.frameworkCoreGraphics.frameworkImageIO.frameworkMapKit.frameworkMessageUI.frameworkMobileCoreServices.frameworkQuartzCore.framework

           

  3. 根据所需渠道导入相应的库文件

  4. 添加 URL Schemes:在 Xcode 中,选择你的工程设置项,选中 "TARGETS" 一栏,在 "Info" 标签栏的 "URL Types" 添加 "URL Schemes",如果使用微信,填入所注册的应用程序 id,如果不使用微信,则自定义,建议起名稍复杂一些,尽量避免与其他程序冲突。

  5. 添加 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‘;
}



郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。