lib 文件夹下是 iOS SDK 文件，
example 文件夹里面是一个简单的接入示例，该示例仅供参考。
当前版本，不需要微信的 SDK，可以正常调用微信支付
iOS SDK 要求 iOS 10.0 及以上版本
-
在
Podfile添加pod 'Pingpp', '~> 2.2.26'
默认会包含支付宝、微信和银联。你也可以自己选择渠道。
目前支持以下模块：Alipay（支付宝移动支付）CBAlipay（支付宝移动支付 - 境外支付）AlipayNoUTDID（支付宝移动支付，独立UTDID.framework）Wx（微信 app 支付）QQWallet（QQ 钱包 app 支付）UnionPay（银联手机支付）ApplePayCmbWallet（招行一网通）BfbWap（百度钱包 Wap 支付）Yeepay（易宝支付 Wap 支付）Jdpay（京东支付 Wap 支付）CcbPay（建设银行 app 支付）Agreement（带扣签约）Cmpay（和包支付）
例如：
pod 'Pingpp/Alipay', '~> 2.2.26' pod 'Pingpp/UnionPay', '~> 2.2.26'
代扣签约
pod 'Pingpp/Agreement', '~> 2.2.26'
-
运行
pod install -
从现在开始使用
.xcworkspace打开项目，而不是.xcodeproj -
添加 URL Schemes：在 Xcode 中，选择你的工程设置项，选中 "TARGETS" 一栏，在 "Info" 标签栏的 "URL Types" 添加 "URL Schemes"，如果使用微信，填入所注册的微信应用程序 id，如果不使用微信，则自定义，允许英文字母和数字，首字母必须是英文字母，建议起名稍复杂一些，尽量避免与其他程序冲突。如果使用 CcbPay，格式为
comccbpay+商户代码(即 MERCHANTID 字段值)+商户自定义的标示，示例：comccbpay105320148140002myapp。 -
2.1.0 及以上版本，可打开 Debug 模式，打印出 log，方便调试。开启方法：
[Pingpp setDebugMode:YES];。 -
2.2.8 及以上版本，可选择是否在 WAP 渠道中支付完成后，点击“返回商户”按钮，直接关闭支付页面。开启方法：
[Pingpp ignoreResultUrl:YES];。
-
获取 SDK
下载 SDK, 里面包含了 lib 文件夹和 example 文件夹。lib 文件夹里面是 SDK 的文件。 -
依赖 Frameworks： 必需：
CFNetwork.framework SystemConfiguration.framework Security.framework QuartzCore.framework CoreTelephony.framework libc++.tbd libz.tbd libsqlite3.0.tbd CoreMotion.framework CoreLocation.frameworkApple Pay 所需：
PassKit.framework -
如果不需要某些渠道，删除
lib/Channels下的相应目录即可。 -
添加 URL Schemes：在 Xcode 中，选择你的工程设置项，选中 "TARGETS" 一栏，在 "Info" 标签栏的 "URL Types" 添加 "URL Schemes"，如果使用微信，填入所注册的微信应用程序 id，如果不使用微信，则自定义，允许英文字母和数字，首字母必须是英文字母，建议起名稍复杂一些，尽量避免与其他程序冲突。
-
添加 Other Linker Flags：在 Build Settings 搜索 Other Linker Flags ，添加
-ObjC。 -
2.1.0 及以上版本，可打开 Debug 模式，打印出 log，方便调试。开启方法：
[Pingpp setDebugMode:YES];。 -
2.2.8 及以上版本，可选择是否在 WAP 渠道中支付完成后，点击“返回商户”按钮，直接关闭支付页面。开启方法：
[Pingpp ignoreResultUrl: YES];。
#import <Pingpp.h>
Objective-C
// data 表示 Charge/Order/Recharge 的 JSON 字符串
[Pingpp createPayment:data
viewController:viewController
appURLScheme:URLScheme
withCompletion:^(NSString *result, PingppError *error) {
if ([result isEqualToString:@"success"]) {
// 支付成功
} else {
// 支付失败或取消
NSLog(@"Error: code=%lu msg=%@", error.code, [error getMsg]);
}
}];Swift
Pingpp.createPayment(data as NSObject, viewController: viewController, appURLScheme: URLScheme) { (result: String?, error: PingppError?) in
if error != nil {
// 处理错误
}
// 处理结果
}渠道为支付宝但未安装支付宝钱包时，交易结果会在调起插件时的 Completion 中返回。渠道为微信、支付宝(安装了支付宝钱包)、银联或者测试模式时，请实现 UIApplicationDelegate 的 - application:openURL:options: 方法:
- (BOOL)application:(UIApplication *)app
openURL:(NSURL *)url
options:(NSDictionary *)options {
BOOL canHandleURL = [Pingpp handleOpenURL:url withCompletion:nil];
return canHandleURL;
}Podfile 添加
pod 'Pingpp/Agreement', '~> 2.2.26'通过服务端获取 agreement 对象后，调用接口
Objective-C
[Pingpp signAgreement:agreement
withCompletion:^(NSString *result, PingppError *error) {
// 处理结果/错误
}];Swift
Pingpp.signAgreement(agreement) { (result: String?, error: PingppError?) in
// 处理结果/错误
}Objective-C
- (BOOL)application:(UIApplication *)app
openURL:(NSURL *)url
options:(NSDictionary *)options {
if ([Pingpp handleOpenURL:url withCompletion:nil]) {
// 这个是处理支付回调的
return YES;
} else if ([Pingpp handleAgreementURL:url withCompletion:nil]) {
// 这个是处理签约回调的，签约回调，目前前端只会在 completion 返回 "unknown"，需要通过服务端查询实际结果
return YES;
}
return NO;
}Swift
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
if Pingpp.handleOpen(url, withCompletion: nil) {
return true
} else if Pingpp.handleAgreementURL(url, withCompletion: nil) {
return true
}
return false
}-
如果需要使用支付宝和微信等跳转至渠道 app 的渠道，需要在
Info.plist添加以下代码：<key>LSApplicationQueriesSchemes</key> <array> <string>weixin</string> <string>wechat</string> <string>alipay</string> <string>alipays</string> <string>mqq</string> <string>mqqwallet</string> <string>uppaysdk</string> <string>uppaywallet</string> <string>uppayx1</string> <string>uppayx2</string> <string>uppayx3</string> <string>cmbmobilebank</string> <string>mbspay</string> <string>cmpay</string> </array>
-
如果 App 需要访问
http://，需要在Info.plist添加如下代码，或者根据需求添加NSExceptionDomains：<key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict>
-
如果编译失败，遇到错误信息为：
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。 -
CmbWallet（招行一网通） 需要把 招行一网通 提供的秘钥CMBPublicKey添加到Info.plist如果是混淆加密的则不需要 如以下代码:<key>CMBPublicKey</key> <string>IwxiAyJIT4tlwJSCbRRE0jZFTvYjt02/CrlutsMzd5O4B9PaVyUmIKSasdasdasdhWTyp3Bb9T7c9ujiUJOJ8y7893grwEae9yiOBoBmByVsCMTaxnc+lMr7A9ifk48Tz61WxsxnQTyYzrIVbuerQIUi3PSORwcPMRqi+XLX8qPXkNpLT9dMvjOasdasdasdUaAdPFc2YFHwl9dHf2ydQsxh1BHvaVO0OO+GtZ04ZKjxRyJW2HfghKLJijl;XTjrWSNizcdoefFKQsTdzvcPNvx7PsxuXKo9SosheeS/SHPk9sGNdwvL55yEBA8gNs0XZbkxJYjuwrwsQInC/N6QSaI0f0kyTA== </string>
-
CmbWallet（招行一网通） 手动导入 : 需要把lib/Channels/CmbWallet目录下的SecreteKeyBoard文件夹手动添加到 工程中的Assets.xcassets添加成功后即可删除 如果是混淆加密的方式直接删除即可； -
CmbWallet（招行一网通） pod 安装 : 需要把Pods/Pingpp/CmbWallet目录下的SecreteKeyBoard文件夹手动添加到 工程中的Assets.xcassets添加成功后即可删除 如果是混淆加密的方式直接删除即可； -
招行一网通 app 支付不需要依赖
CmbWallet模块和上述CmbWallet相关配置，模块已经包含在Pingpp/Core里面。需要用到URL Schemes，创建charge时，在extra[result_url]字段传入<SCHEME>://pingppcmbwallet，其中<SCHEME>是你自定的URL Schemes； -
判断设备上是否已经安装招商银行 app 的方法：
[Pingpp isCmbWalletInstalled]。 -
使用 CcbPay 请先确保用户手机安装了建设银行 app。判断设备上是否已经安装建设银行 app 的方法：
[Pingpp isCcbAppInstalled]。 -
使用 CcbPay 的情况，需要在
Info.plist的NSAppTransportSecurity字段添加相应的NSExceptionDomains<key>NSExceptionDomains</key> <dict> <key>ibsbjstar.ccb.com.cn</key> <dict> <key>NSExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSExceptionRequiresForwardSecrecy</key> <false/> <key>NSIncludesSubdomains</key> <true/> </dict> </dict>
- 测试时必须是真机进行测试
- 检查相关的证书是否正确
- 手机必须是 iPhone 6 以上
- 支付时必须绑定了真实的银行卡且有充足的余额
使用阿里百川等阿里系的 SDK 时，可能会出现冲突，请尝试使用 pod 'Pingpp/AlipayNoUTDID' 代替 pod 'Pingpp/Alipay'。
因为 CocoaPods 的限制，只有编译通过的才能上传成功，所以使用时，需要删除项目中已经存在的 UTDID.framework。