简介：本文深入解析苹果内购（IAP）非订阅型商品充值全流程，涵盖初始化、商品请求、交易处理、验证及异常处理等关键环节，助力开发者高效实现内购功能。

苹果内购（IAP）从入门到精通（3）- 商品充值流程（非订阅型）

在iOS应用生态中，苹果内购（In-App Purchase, IAP）是开发者实现应用内虚拟商品或服务变现的核心机制。对于非订阅型商品（如游戏道具、一次性解锁功能等），其充值流程的设计与实现直接影响用户体验和收入转化。本文将系统梳理非订阅型商品的充值全流程，从初始化到交易验证，为开发者提供可落地的技术指南。

一、IAP非订阅商品充值流程核心环节

1. 初始化StoreKit框架

StoreKit是苹果提供的内购API框架，开发者需在应用启动时完成初始化配置。关键步骤包括：

检查设备支持性：通过SKPaymentQueue.canMakePayments()判断用户是否允许内购。

添加支付队列监听：实现SKPaymentTransactionObserver协议，监听交易状态变化。

class IAPManager: NSObject, SKPaymentTransactionObserver {
  override init() {
      super.init()
      SKPaymentQueue.default().add(self)
  }
  func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {
      // 处理交易状态更新
  }
}

2. 商品信息请求与展示

开发者需在App Store Connect中配置商品ID（如com.example.app.100coins），并通过SKProductsRequest获取商品详情：

func fetchProductInfo(productIds: [String]) {
    let request = SKProductsRequest(productIdentifiers: Set(productIds))
    request.delegate = self
    request.start()
}
extension IAPManager: SKProductsRequestDelegate {
    func productsRequest(_ request: SKProductsRequest, didReceive response: SKProductsResponse) {
        let validProducts = response.products // 有效商品列表
        let invalidProducts = response.invalidProductIdentifiers // 无效商品ID
        // 更新UI展示商品价格、名称等信息
    }
}

注意事项：

商品ID需与App Store Connect配置完全一致。
沙盒环境与生产环境的商品ID需保持同步。

3. 发起支付请求

用户选择商品后，需创建SKPayment对象并添加到支付队列：

func purchase(product: SKProduct) {
    let payment = SKPayment(product: product)
    SKPaymentQueue.default().add(payment)
}

关键点：

避免重复添加相同商品的支付请求。
沙盒测试时需使用测试账号（非真实Apple ID）。

4. 交易状态处理

交易状态通过SKPaymentTransactionObserver回调，需处理以下状态：

.purchasing：交易进行中，可显示加载状态。
.purchased：交易成功，需交付商品并完成交易。
.failed：交易失败，需解析错误原因（如SKError.paymentCancelled）。
.restored：恢复购买（非首次购买）。

func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {
    for transaction in transactions {
        switch transaction.transactionState {
        case .purchased:
            deliverProduct(for: transaction) // 交付商品
            completeTransaction(transaction) // 完成交易
        case .failed:
            if let error = transaction.error as? SKError {
                print("支付失败: \(error.localizedDescription)")
            }
            SKPaymentQueue.default().finishTransaction(transaction)
        default:
            break
        }
    }
}

5. 服务器验证与收据处理

为防止伪造交易，开发者需将交易收据发送至服务器，由服务器向苹果验证收据有效性：

func completeTransaction(_ transaction: SKPaymentTransaction) {
    guard let receiptData = transaction.transactionReceipt else { return }
    let receiptString = receiptData.base64EncodedString()
    // 将receiptString发送至服务器验证
    SKPaymentQueue.default().finishTransaction(transaction)
}

服务器验证流程：

开发者服务器接收收据并转发至苹果验证接口（生产环境：https://buy.itunes.apple.com/verifyReceipt，沙盒环境：https://sandbox.itunes.apple.com/verifyReceipt）。
解析苹果返回的JSON响应，检查status字段（0表示成功）。
验证成功后，为用户解锁商品权限。

6. 异常处理与重试机制

常见异常场景及解决方案：

网络中断：监听SKError.cloudServiceNetworkConnectionFailed，提示用户检查网络后重试。
收据验证失败：服务器返回status=21007时，需切换至沙盒环境重试。
用户取消支付：捕获SKError.paymentCancelled，优雅退出支付流程。

二、最佳实践与优化建议

1. 用户体验优化

加载状态反馈：在交易进行时显示加载动画，避免用户重复点击。
错误提示友好化：将SKError代码转换为用户可理解的提示（如“支付失败，请稍后重试”）。
恢复购买入口：为已购买用户提供恢复按钮，避免重复付费。

2. 安全性增强

收据本地缓存：缓存最近一次有效收据，减少服务器验证请求。
防篡改检查：服务器验证时检查收据中的bundle_id和product_id是否匹配。
日志记录：记录所有交易状态变化，便于排查问题。

3. 测试策略

沙盒测试：使用测试账号模拟成功、失败、取消等场景。
边界测试：测试网络中断、应用被杀进程等异常情况。
性能测试：验证高并发下收据验证的响应时间。

三、常见问题与解决方案

1. 商品未显示

原因：商品ID未正确配置或未提交审核。
解决：检查App Store Connect中的商品状态，确保为“准备提交”或“已批准”。

2. 交易卡在“.purchasing”状态

原因：未实现paymentQueue回调。
解决：确认IAPManager实例被正确持有（如作为单例）。

3. 服务器验证失败

原因：收据格式错误或环境配置错误。
解决：检查收据是否为Base64编码，并确认验证URL是否匹配环境。

四、总结

非订阅型商品的充值流程涉及客户端初始化、商品请求、支付发起、状态处理、服务器验证等多个环节。开发者需严格遵循苹果的IAP规范，同时通过优化用户体验、增强安全性和完善测试策略，确保支付流程的稳定性和可靠性。掌握这些核心要点后，开发者可高效实现IAP功能，为用户提供流畅的付费体验。

苹果内购（IAP）非订阅商品充值全流程解析