Judopay Objective-C SDK

Judopay Objective-C SDK 是一个用于在您的应用程序内部集成简单、快速和安全的支付的框架。它包含了一套详尽的移动内支付和安全工具包，使得集成变得简单和快捷。如果您正在用 Swift 集成应用程序，我们强烈推荐使用 JudoKit。

使用我们的 UI 组件来捕获卡数据的无缝用户体验。通过可以主题化或定制的 UI 来最小化您的 PCI 范围。

要求

• 版本 >= 7.0 需要 Xcode 9 和 Swift 4。
• 版本 >= 6.2.5 需要 Xcode 8 和 Swift 3。
• 6.2.4 版是最后支持 Xcode 7.3.1 和 Swift 2.2 的版本。

入门指南

1. 集成

将 #import <JudoKitObjC/JudoKitObjC.h> 添加到您想使用 SDK 的文件顶部。

如果您使用 Cocoapods 进行集成，请按照以下步骤操作（如果您基于 Carthage 进行集成，请访问 https://github.com/JudoPay/JudoKitObjC/wiki/Carthage）。

• 您可以使用以下命令安装 CocoaPods

$ gem install cocoapods

• 将 JudoKitObjC 添加到您的 Podfile 以将其集成到 Xcode 项目中

platform :ios, '10.0'

pod 'JudoKitObjC', '~> 7.1'

• 然后，运行以下命令

$ pod install

• 请确保始终使用新生成的 .xcworkspace 文件，而不是项目中的 .xcodeproj 文件。
• 在您的 Xcode 环境中，转到名为 Pods 的 Project Navigator（蓝色项目图标），选择 JudoKitObjC 目标并打开名为 Build Phases 的选项卡。
• 添加一个新的 Run Script Phase 并将其拖放到 Compile Sources 构建阶段之上。
• 在 shell 脚本中，粘贴以下行

sh "${PODS_ROOT}/DeviceDNA/Framework/strip-frameworks-cocoapods.sh"

2. 设置

您可以在初始化会话时在此处设置令牌和密钥

// initialize the SDK by setting it up with a token and a secret
self.judoKitSession = [[JudoKit alloc] initWithToken:token secret:secret];

为了指示 SDK 与沙盒进行通信，请将以下行添加到应启动支付的 ViewController 中

// setting the SDK to Sandbox Mode - once this is set, the SDK wil stay in Sandbox mode until the process is killed
self.judoKitSession.apiSession.sandboxed = YES;

当您准备上线时，可以删除此行。

3. 进行支付

    JPAmount *amount = [[JPAmount alloc] initWithAmount:@"25.0" currency:@"GBP"];
    
    [self.judoKitSession invokePayment:judoID amount:amount consumerReference:@"consRef" cardDetails:nil completion:^(JPResponse * response, NSError * error) {
        if (error || response.items.count == 0) {
            if (error.domain == JudoErrorDomain && error.code == JudoErrorUserDidCancel) {
                [self dismissViewControllerAnimated:YES completion:nil];
            } else {
	            // handle error
            }
        } else {
        	// handle success
        }
    }];

注意：请确保您为每位不同的消费者使用唯一的消费者参考。

下一步

Judo 的 Objective-C SDK 支持一系列自定义选项。有关在 iOS 上使用 Judopay 的更多信息，请参阅我们的 wiki 文档 或 API 参考。