Pingpp iOS SDK

简介

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

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

版本要求

iOS SDK 要求 iOS 7.0 及以上版本

接入方法

安装

使用 CocoaPods

1. 在 Podfile 添加

   pod 'Pingpp', '~> 2.2.18'
   

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

   • Alipay（支付宝移动支付）
   • AlipayNoUTDID（支付宝移动支付，独立 UTDID.framework）
   • Wx（微信 App 支付）
   • QQWallet（QQ钱包 App 支付）
   • UnionPay（银联手机支付）
   • ApplePay
   • CmbWallet（招行一网通）
   • BfbWap（百度钱包 Wap 支付）
   • Yeepay（易宝支付 Wap 支付）
   • Jdpay（京东支付 Wap 支付）
   • One（壹收款）

   例如：

   pod 'Pingpp/Alipay', '~> 2.2.18'
   pod 'Pingpp/UnionPay', '~> 2.2.18'
   pod 'Pingpp/One', '~> 2.2.18'
   

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]; 。

额外配置

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

   <key>LSApplicationQueriesSchemes</key>
   <array>
       <string>weixin</string>
       <string>wechat</string>
       <string>alipay</string>
       <string>alipays</string>
       <string>mqq</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 添加成功后即可删除 如果是混淆加密的方式直接删除即可

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

注意事项

* 如果不需要 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。