atuooo / pingpp-ios

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Pingpp iOS SDK

目录

简介

lib 文件夹下是 iOS SDK 文件,
example 文件夹里面是一个简单的接入示例,该示例仅供参考。

当前版本,不需要微信的 SDK,可以正常调用微信支付

版本要求

iOS SDK 要求 iOS 7.0 及以上版本

接入方法

使用 CocoaPods

  1. Podfile 添加

    pod 'Pingpp', '~> 2.2.20'
    

    默认会包含支付宝、微信和银联。你也可以自己选择渠道。
    目前支持以下模块:

    • Alipay(支付宝移动支付)
    • CBAlipay(支付宝移动支付 - 境外支付)
    • AlipayNoUTDID(支付宝移动支付,独立 UTDID.framework
    • Wx(微信 App 支付)
    • QQWallet(QQ钱包 App 支付)
    • UnionPay(银联手机支付)
    • ApplePay
    • CmbWallet(招行一网通)
    • BfbWap(百度钱包 Wap 支付)
    • Yeepay(易宝支付 Wap 支付)
    • Jdpay(京东支付 Wap 支付)
    • UI(Ping++ SDK UI 版)

    例如:

    pod 'Pingpp/Alipay', '~> 2.2.20'
    pod 'Pingpp/UnionPay', '~> 2.2.20'
    
    

    Ping++ SDK UI 版

    pod 'Pingpp/UI', '~> '2.2.20'
    
  2. 运行 pod install

  3. 从现在开始使用 .xcworkspace 打开项目,而不是 .xcodeproj

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

  5. 2.1.0 及以上版本,可打开 Debug 模式,打印出 log,方便调试。开启方法:[Pingpp setDebugMode:YES];

  6. 2.2.8 及以上版本,可选择是否在 WAP 渠道中支付完成后,点击“返回商户”按钮,直接关闭支付页面。开启方法:[Pingpp ignoreResultUrl: YES];

手动导入

  1. 获取 SDK
    下载 SDK, 里面包含了 lib 文件夹和 example 文件夹。lib 文件夹里面是 SDK 的文件。

  2. 依赖 Frameworks: 必需:

    CFNetwork.framework
    SystemConfiguration.framework
    Security.framework
    QuartzCore.framework
    CoreTelephony.framework
    libc++.tbd
    libz.tbd
    libsqlite3.0.tbd
    libstdc++.tbd
    CoreMotion.framework
    CoreLocation.framework
    

    Apple Pay 所需:

    PassKit.framework
    
  3. 如果不需要某些渠道,删除 lib/Channels 下的相应目录即可。

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

  5. 添加 Other Linker Flags:在 Build Settings 搜索 Other Linker Flags ,添加 -ObjC

  6. 2.1.0 及以上版本,可打开 Debug 模式,打印出 log,方便调试。开启方法:[Pingpp setDebugMode:YES];

  7. 2.2.8 及以上版本,可选择是否在 WAP 渠道中支付完成后,点击“返回商户”按钮,直接关闭支付页面。开启方法:[Pingpp ignoreResultUrl: YES];

接入方法

使用 Ping++ 标准版 SDK

#import <Pingpp.h>
[Pingpp createPayment:charge
           viewController:viewController
             appURLScheme:kUrlScheme
           withCompletion:^(NSString *result, PingppError *error) {
               if ([result isEqualToString:@"success"]) {
                   // 支付成功
               } else {
                   // 支付失败或取消
                   NSLog(@"Error: code=%lu msg=%@", error.code, [error getMsg]);
               }
}];

使用 Ping++ UI版 SDK

使用 UI 版本且不想展示 Ping++ 提供的广告请联系我们

#import <Pingpp+UI.h>

带渠道选择页面

/**
 *  设置需要显示的渠道按钮(有序)
 *  @param  channels  渠道数组,与 API 的 channel 字段对应。 例: @[@"wx",@"alipay", @"upacp", @"bfb_wap"]
 */
[Pingpp enableChannels:channels];
 
//调起支付页面
[Pingpp payWithOrderNo:orderNo // 订单号
                    amount:100 // 金额
                    params:nil // 自定义参数,请求 chargeURL 时,会放在 custom_params 字段
                 chargeURL:chargeURL // 壹收款会向该地址发送请求,该地址需要返回 charge 的 JSON 字符串
              appURLScheme:appURLScheme // Info.plist 中填写的 URL Scheme,支付宝渠道和测试模式需要
            viewController:self // 当前的 ViewController
         completionHandler:^(NSString * _Nonnull result, PingppURLResponse * _Nullable response, NSError * _Nullable error) {
 
        // 根据result判断支付是否成功
        NSLog(@"result=%@", result);
        if (response && response.responseString) {
            NSLog(@"response.responseString=%@", response.responseString);
        }
        if (error) {
            NSLog(@"completion error code:%lu domain:%@ userInfo:%@", error.code, error.domain, error.userInfo);
        }
}];

不带渠道选择页面

[Pingpp createPay:string
       viewController:self
         appURLScheme:kUrlScheme
       withCompletion:^(NSString *result, PingppError *error) {
        // 根据result判断支付是否成功
        NSLog(@"result=%@", result);
        if (response && response.responseString) {
            NSLog(@"response.responseString=%@", response.responseString);
        }
        if (error) {
            NSLog(@"completion error code:%lu domain:%@ userInfo:%@", error.code, error.domain, error.userInfo);
        }
} ];

接收并处理交易结果

渠道为支付宝但未安装支付宝钱包时,交易结果会在调起插件时的 Completion 中返回。渠道为微信、支付宝(安装了支付宝钱包)、银联或者测试模式时,请实现 UIApplicationDelegate 的 - application:openURL:xxxx: 方法:
iOS 8 及以下
- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation {

    BOOL canHandleURL = [Pingpp handleOpenURL:url withCompletion:nil];

    return canHandleURL;
}
iOS 9 及以上
- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary *)options {

    BOOL canHandleURL = [Pingpp handleOpenURL:url withCompletion:nil];

    return canHandleURL;
}

额外配置

  1. iOS 9 以上版本如果需要使用支付宝和微信渠道,需要在 Info.plist 添加以下代码:

    <key>LSApplicationQueriesSchemes</key>
    <array>
        <string>weixin</string>
        <string>wechat</string>
        <string>alipay</string>
        <string>alipays</string>
        <string>mqq</string>
        <string>uppaysdk</string>
        <string>uppaywallet</string>
        <string>uppayx1</string>
        <string>uppayx2</string>
        <string>uppayx3</string>
    </array>
    
  2. iOS 9 限制了 http 协议的访问,如果 App 需要访问 http://,需要在 Info.plist 添加如下代码:

    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>
    
  3. 如果编译失败,遇到错误信息为:

    XXXXXXX does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE), obtain an updated library from the vendor, or disable bitcode for this target.
    

    请到 Xcode 项目的 Build Settings 标签页搜索 bitcode,将 Enable Bitcode 设置为 NO

  4. CmbWallet(招行一网通) 需要把 招行一网通 提供的秘钥CMBPublicKey 添加到 Info.plist 如果是混淆加密的则不需要 如以下代码:

    <key>CMBPublicKey</key>          
        <string>IwxiAyJIT4tlwJSCbRRE0jZFTvYjt02/CrlutsMzd5O4B9PaVyUmIKSasdasdasdhWTyp3Bb9T7c9ujiUJOJ8y7893grwEae9yiOBoBmByVsCMTaxnc+lMr7A9ifk48Tz61WxsxnQTyYzrIVbuerQIUi3PSORwcPMRqi+XLX8qPXkNpLT9dMvjOasdasdasdUaAdPFc2YFHwl9dHf2ydQsxh1BHvaVO0OO+GtZ04ZKjxRyJW2HfghKLJijl;XTjrWSNizcdoefFKQsTdzvcPNvx7PsxuXKo9SosheeS/SHPk9sGNdwvL55yEBA8gNs0XZbkxJYjuwrwsQInC/N6QSaI0f0kyTA==
        </string>
    
  5. CmbWallet(招行一网通) 手动导入 : 需要把 lib/Channels/CmbWallet目录下的 SecreteKeyBoard文件夹手动添加到 工程中的 Assets.xcassets 添加成功后即可删除 如果是混淆加密的方式直接删除即可

  6. CmbWallet(招行一网通) pod 安装 : 需要把 Pods/Pingpp/CmbWallet目录下的 SecreteKeyBoard文件夹手动添加到 工程中的 Assets.xcassets 添加成功后即可删除 如果是混淆加密的方式直接删除即可

注意事项

* 如果不需要 Apple Pay,请不要导入 Apple Pay 的静态库。以免提交到 App Store 时审核不通过。

* 如果 集成 Apple Pay 测试时请注意 以下几点

  1. 测试时必须是真机进行测试
  2. 检查相关的证书是否正确
  3. 手机必须是 iPhone 6 以上 ,并且系统 iOS 9 以上
  4. 支付时必须绑定了真实的银行卡且有充足的余额

* 请勿直接使用客户端支付结果作为最终判定订单状态的依据,支付状态以服务端为准!!!在收到客户端同步返回结果时,请向自己的服务端请求来查询订单状态。

* 支付宝渠道发生包冲突的情况

使用阿里百川等阿里系的 SDK 时,可能会出现冲突,请尝试使用 pod 'Pingpp/AlipayNoUTDID' 代替 pod 'Pingpp/Alipay'

因为 CocoaPods 的限制,只有编译通过的才能上传成功,所以使用时,需要删除项目中已经存在的 UTDID.framework

关于如何使用 SDK 请参考 开发者中心 或者 example 文件夹里的示例。

About


Languages

Language:Objective-C 45.9%Language:Objective-C++ 30.9%Language:Swift 13.2%Language:Ruby 7.8%Language:HTML 2.2%