Primer iOS SDK

💪iOS SDK 的特性

💳  使用我们高度可定制的通用结账创建出色的支付体验

🧩  无需一行代码即可连接和配置任何新的支付方式

✅  动态处理处理器之间的 3DS 2.0 并为 SCA 准备就绪

♻️  存储支付方式以进行定期和重复支付

🔒  无需重定向客户即可始终符合 PCI 标准化

📚文档

请考虑查看以下资源

• 文档
• 客户端会话创建
• API 参考
• 变更日志
• 详细 iOS 文档

💡支持

对于任何支持或集成相关查询，请随时 联系我们。

🚀快速入门

查看我们的 快速入门指南，了解如何使用通用结账接受您的第一笔付款。

🧱安装

使用 CocoaPods

iOS SDK 可通过 Cocoapods 使用。只需添加 PrimerSDK pod 并运行 pod install。

target 'MyApp' do
  # Other pods...

  # Add this to your Podfile
  pod 'PrimerSDK' # Add this line
end

有关 SDK 的特定版本，请参阅变更日志。

使用 Swift 包管理器

Swift 包管理器是一个用于自动化 Swift 代码分发的工具，它集成到了 Xcode 中。为了使用 Swift 包管理器添加 PrimerSDK；

1. 选择您的项目，然后导航到“包依赖项”
2. 在“包”部分的左下角点击加号按钮
3. 将 https://github.com/primer-io/primer-sdk-ios.git 剪贴到搜索栏
4. 点击“添加包”
5. 让 Xcode 下载包并设置一切

🔧使用方法

📋先决条件

• 🔒通过在您的后端中创建客户端会话来生成客户端令牌 生成客户端会话。
• 🎉 就是这样！

🔍 初始化 SDK

导入 Primer SDK 并将其委托设置为以下示例所示

import PrimerSDK

class MyViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()

        // Initialize the SDK with the default settings.
        Primer.shared.configure(delegate: self)
    }
}

extension MyViewController: PrimerDelegate {

    func primerDidCompleteCheckoutWithData(_ data: CheckoutData) {
        // Primer checkout completed with data
        // do something...
    }
}

注意：查看 SDK API 参考 了解更多自定义 SDK 的选项。

🔍 渲染结账

现在您可以在后端使用您生成的客户端令牌。调用 showUniversalCheckout(clientToken) 函数（如下所示）以显示通用结账。

class MyViewController: UIViewController {
    func startUniversalCheckout() {
        Primer.shared.showUniversalCheckout(clientToken: self.clientToken)
    }
}

您现在应该能看到通用结账！用户可以与通用结账交互，SDK 将创建支付。支付数据将在 primerDidCompleteCheckoutWithData(:) 上返回。

注意：通用结账可以有更多选项。请参阅下文了解更多信息。

贡献指南

贡献文档

示例 App

请确保您已安装CocoaPods

• 在仓库根目录下，打开您的终端
  • cd Example
  • pod install