PayPal iOS SDK 使用指南

项目介绍

PayPal iOS SDK 是由 PayPal 开发的一个用于在iOS应用中集成支付功能的开源库。它支持接收信用卡和PayPal账户的一次性支付、未来支付及档案分享功能。请注意，此SDK已废弃直接信用卡支付功能，并推荐使用Braintree作为替代方案来处理包括PayPal在内的多种支付方式。适用于Xcode 8及以上版本，兼容iOS 7.0+，支持armv7、armv7s和arm64架构设备。

项目快速启动

安装

使用CocoaPods

如果你的项目使用CocoaPods管理依赖，可以在你的Podfile中加入以下行：

platform :ios, '7.0'
pod 'PayPal-iOS-SDK'

之后执行 pod install 来安装。

手动集成

如果不使用CocoaPods，你可以通过克隆仓库或者下载zip文件得到SDK。然后将PayPalMobile目录（包含一些.h头文件和libPayPalMobile.a静态库）添加到你的Xcode项目里。记得设置“Copy items if needed”并选择“Create groups”。更新你的Build Settings，添加 -lc++ -ObjC 到Other Linker Flags，并启用Enable Modules (C and Objective-C)以及Link Frameworks Automatically。

快速集成示例

为了进行一次简单的支付，你需要配置环境并调用相应的API。下面是一个简化版的快速启动代码示例：

import PayPalMobile

// 在应用程序启动时初始化PayPalClient
if let Bundle = Bundle(for: PayPalCheckoutViewController.self) {
    PayPalClient.shared().initialize(with: Bundle)
}

// 引导用户进入支付流程
let config = PayPalConfiguration四项初始化...
let paymentAmount = NSDecimalNumber(string: "10.00")
let paymentCurrency = "USD"
let payerInfo = PayerInfo(email: "[e-mail]") // 示例值，实际应动态获取
let payment = Payment(amount: paymentAmount, currency: paymentCurrency, shortDescription: "商品描述", payer: payerInfo)

PayPalCheckoutViewController.present(payment: payment, configuration: config, from: self) { result in
    switch result {
        case .success(let payment):
            print("支付成功，服务器端验证待完成...")
            // 这里你应该向你的服务器发送payment Token进行验证和后续处理
        case .cancel:
            print("用户取消支付")
        case .failure(let error):
            print("支付失败: \(error.localizedDescription)")
    }
}

请注意，真实环境中需要替换示例值并处理更多细节，例如真实的payer信息和错误处理。

应用案例和最佳实践

应用案例通常涉及在购物车页面集成支付按钮、在确认订单页面使用SDK发起支付请求等。最佳实践中，确保在生产环境中使用正确的客户端ID和密钥，且在测试阶段使用沙箱环境以避免实际财务操作。还要确保实现充分的错误处理机制，提升用户体验。

典型生态项目

虽然直接列举特定的“典型生态项目”较为困难，但PayPal的集成广泛存在于电商应用、慈善捐赠、预定服务等多种类型的iOS应用中。开发者可以参考PayPal提供的样本应用和其文档中的实例，学习如何将其功能融入到各种业务场景中。比如，“Future Payments”的模式常被订阅服务类应用采用，允许用户一次性授权后进行持续支付，而“Profile Sharing”则常见于需要用户同意分享个人信息的应用。

---

以上就是基于给定的GitHub仓库链接，关于PayPal iOS SDK的基本使用文档概览。实际集成过程需详细阅读官方文档和遵循最佳实践以确保应用的安全性和稳定性。