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

一、非订阅型商品充值的核心概念

苹果内购（IAP）的非订阅型商品（Non-Consumable/Consumable）指用户一次性购买后永久拥有或可重复消耗的虚拟商品（如游戏货币、道具、解锁功能等）。与订阅型商品不同，其交易流程无需处理周期性续费或状态管理，但需确保交易安全性和数据一致性。

关键特性：

1. 交易类型：分为可消耗型（Consumable，如金币）和不可消耗型（Non-Consumable，如永久关卡）。
2. 支付流程：用户发起购买→应用验证收据→服务器交付商品。
3. 数据持久化：需在服务器记录用户已购商品，防止重复购买或数据丢失。

二、配置准备：App Store Connect与Xcode设置

1. App Store Connect配置

• 步骤1：登录App Store Connect，进入“我的App”→选择应用→“功能”→“App内购买项目”。
• 步骤2：创建非订阅型商品：
  • 类型选择：Consumable（可消耗）或Non-Consumable（不可消耗）。
  • 参考名称：如“100金币包”“高级功能解锁”。
  • 产品ID：全局唯一标识符（如com.example.app.100coins）。
  • 定价与地区：设置价格梯度及适用地区。
• 步骤3：上传截图（展示商品在应用中的使用场景），提交审核。

2. Xcode项目配置

• 启用IAP能力：在Signing & Capabilities中添加In-App Purchase。
• 配置沙盒测试账号：在Settings→Apple ID→退出当前账号→使用沙盒账号登录测试。

三、客户端实现：Swift代码详解

1. 请求商品列表

import StoreKit
class IAPManager: NSObject, SKProductsRequestDelegate {
    var products: [SKProduct] = []
    func fetchProducts() {
        let productIDs = Set(["com.example.app.100coins", "com.example.app.unlock"])
        let request = SKProductsRequest(productIdentifiers: productIDs)
        request.delegate = self
        request.start()
    }
    func productsRequest(_ request: SKProductsRequest, didReceive response: SKProductsResponse) {
        products = response.products
        // 更新UI显示商品列表
    }
}

2. 发起购买流程

func purchaseProduct(_ product: SKProduct) {
    let payment = SKPayment(product: product)
    SKPaymentQueue.default().add(payment)
}
// 监听交易状态
func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {
    for transaction in transactions {
        switch transaction.transactionState {
        case .purchased:
            verifyReceipt(transaction: transaction) // 验证收据
            SKPaymentQueue.default().finishTransaction(transaction)
        case .failed:
            print("购买失败: \(transaction.error?.localizedDescription ?? "")")
            SKPaymentQueue.default().finishTransaction(transaction)
        default:
            break
        }
    }
}

四、服务器端验证：确保交易安全

1. 收据验证流程

• 客户端：购买成功后，从transaction.transactionReceipt获取收据数据（iOS 7+需通过Bundle.main.appStoreReceiptURL获取）。
• 服务器端：将收据发送至苹果验证服务器（生产环境使用https://buy.itunes.apple.com/verifyReceipt，沙盒环境使用https://sandbox.itunes.apple.com/verifyReceipt）。

2. 示例验证代码（Node.js）

const https = require('https');
async function verifyReceipt(receiptData, isSandbox = false) {
    const postData = JSON.stringify({
        'receipt-data': receiptData,
        'password': '共享密钥（可选）'
    });
    const options = {
        hostname: isSandbox ? 'sandbox.itunes.apple.com' : 'buy.itunes.apple.com',
        port: 443,
        path: '/verifyReceipt',
        method: 'POST',
        headers: { 'Content-Type': 'application/json' }
    };
    return new Promise((resolve, reject) => {
        const req = https.request(options, (res) => {
            let data = '';
            res.on('data', (chunk) => data += chunk);
            res.on('end', () => resolve(JSON.parse(data)));
        });
        req.on('error', reject);
        req.write(postData);
        req.end();
    });
}

3. 验证结果处理

• 成功响应：检查status === 0，解析receipt.in_app数组获取商品信息。
• 错误处理：
  • 21007：沙盒收据发送至生产环境，需重试沙盒地址。
  • 21002：收据数据无效，拒绝交付商品。

五、商品交付与数据持久化

1. 客户端交付逻辑

func deliverProduct(_ productID: String) {
    if productID == "com.example.app.100coins" {
        UserDefaults.standard.set(
            (UserDefaults.standard.integer(forKey: "coins") + 100), 
            forKey: "coins"
        )
    }
    // 通知服务器更新用户数据
}

2. 服务器端持久化建议

• 使用数据库记录用户购买历史（如MySQL的purchases表）。
• 实现幂等性检查：防止重复交付同一收据。

六、异常处理与最佳实践

1. 常见问题解决方案

• 收据验证失败：检查网络权限、沙盒/生产环境匹配。
• 用户未收到商品：实现“恢复购买”功能（调用SKPaymentQueue.default().restoreCompletedTransactions()）。
• 掉单处理：服务器定期对账，补发未确认交易。

2. 测试技巧

• 使用沙盒账号模拟不同场景：
  • 成功购买
  • 支付中断（如关闭App）
  • 重复购买同一商品
• 使用StoreKit Testing（Xcode 14+）加速测试流程。

3. 安全建议

• 禁止客户端解析收据，所有验证必须在服务器完成。
• 使用HTTPS加密通信，防止中间人攻击。
• 定期轮换共享密钥（Shared Secret）。

七、总结与进阶方向

非订阅型商品充值的完整流程包括：配置商品→客户端请求→发起支付→服务器验证→交付商品→异常处理。开发者需重点关注收据验证的安全性和数据一致性。进阶方向可探索：

1. 集成促销活动（如限时折扣）。
2. 实现跨平台商品同步（如iOS与Android数据互通）。
3. 使用苹果的SKAdNetwork追踪支付转化率。

通过系统化掌握上述流程，开发者能够高效集成IAP功能，提升应用变现能力。