本文始发于我的博文 iOS In-App Purchase(IAP) 流程与实现，现转发至此。

一、前言

最近做了 iOS 应用内购买，踩了很多坑，介绍下流程和简单的实现，希望能帮助其他人快速实现功能。

可以看我上传到 Github 的代码 ZInAppPurchase，或者直接在 CocoaPods 拉取 ZInAppPurchase。（第一次试试上传到 CocoaPods，还没加 demo），也可以使用普遍用到的第三方库 SwiftyStoreKit。

二、应用内购买流程

iOS 应用内购买流程主要分几步：

1. iTunes Connect 商品配置
2. 添加沙盒环境技术测试员并登录
3. App 内获取和购买商品
4. 验证购买凭证 receipt
5. 丢单处理
6. 自动续订的订阅商品的处理
7. 多 App 账号同个苹果账号的权益处理/恢复订阅

2.1 iTunes Connect 商品配置

主要是填写完整信息和添加商品。

2.1.1 填写完整信息

登录 iTunes Connect，进入”协议、税务和银行业务“。

如果 Contracts In Process下有 All(See Contract) 和 Contact Info、Bank Info、Tax Info 三列，则表示已填写；否则点击 Request 按照提示进行操作。
之后就会出现 Contact Info、Bank Info、Tax Info 三列，分别 Set Up (需要同公司财务人员一起填写)。

如果没有填写完整只能添加免费订阅商品

2.1.2 添加商品

登录 iTunes Connect，进入我的 App——功能——App内购买项目，点击+号。可以添加的类型有：消耗型项目、非消耗型项目、自动续订订阅、免费订阅、非续订订阅。商品添加完屏幕快照就会变成准备提交状态。

产品 ID 不可重复，如果删除某个商品，以后这个产品的 ID 也不可用，即使它已经被删除了；另外类型也不能改，选错了只能重新增加一个商品。

2.2 添加沙盒环境技术测试员并登录

创建沙盒账户，退出手机 App Store 账户，登录沙盒账户。

2.2.1 创建沙盒账户

登录 iTunes Connect，进入用户和职能——沙盒技术测试员，点击+号。

必须是未注册的 Apple 账户，用于测试购买。

点击新建的账号，可以中断购买流程、修改订阅项目续期率、删除账户，

最好看下每个的说明，有些容易忽略的点，节省后面的测试时间。

点击右上角“编辑”，再勾选沙盒账户，可以清除购买历史记录、删除账户。

2.2.2 登录沙盒账户

在手机 App Store ，点击右上角按钮，然后在新页面一直往下滑，点击”退出登录“。
在手机 设置-App Store-沙盒账户，登录创建的沙盒账户。

如果不操作上面的步骤，直接 Debug，或者下载使用 TestFlight 的包，默认是使用手机登录的 App Store 账户当沙盒账户去测试。
这样会导致一些问题，已知的问题是订阅后再点击订阅会生成一个去苹果验证不存在的交易编号。
而且自己的苹果账号作为沙盒账号，点击后选择管理，会加载不出来或者提示访问不了。

2.3 App 内获取和购买商品

• 导入系统库 StoreKit

import StoreKit

• 获取商品信息

根据 productId 获取商品信息(可以获取多个)：

let productRequest = SKProductsRequest(productIdentifiers: Set<String>(arrayLiteral: productId))
productRequest.delegate = self
productRequest.start()

实现 SKProductsRequestDelegate：

func productsRequest(request: SKProductsRequest, didReceiveResponse response: SKProductsResponse) {
    if let product = response.products.first {// 获取返回的商品
    }
}

• 购买商品

购买获取的商品 product：

if SKPaymentQueue.canMakePayments() {// 是否能且允许支付
    let payment = SKPayment(product: product)
    SKPaymentQueue.defaultQueue().addTransactionObserver(self)
    SKPaymentQueue.defaultQueue().addPayment(payment)
}

实现 SKPaymentTransactionObserver：

func paymentQueue(queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {

    for transaction in transactions {
        switch transaction.transactionState {
        case .Purchased: // Transaction is in queue, user has been charged.  Client should complete the transaction.

            if let receiptUrl = NSBundle.mainBundle().appStoreReceiptURL, let receiptData = NSData(contentsOfURL: receiptUrl) {
                let receiptString = receiptData.base64EncodedStringWithOptions(NSDataBase64EncodingOptions(rawValue: 0))
                // 将receiptString发给服务器
            }
            SKPaymentQueue.defaultQueue().finishTransaction(transaction)

        case .Failed: // Transaction was cancelled or failed before being added to the server queue.

            if let errorCode = transaction.error?.code {
            }
            SKPaymentQueue.defaultQueue().finishTransaction(transaction)
        default:
            break
        }
    }
}

2.4 验证购买凭证 receipt

凭证验证可以本地验证，也可以发给服务器，由服务器提交给 App Store 验证。

参考链接：Validating Receipts With the App Store

我们是将 receipt 进行 base64 编码后，传给服务器，服务器判断凭证是否已经存在或验证过，再去 POST 给 Apple 服务器验证。

服务器会需要用到“App 专用共享密钥”，在 appstoreconnect.apple.com - App 信息 可以查看。

• 沙盒环境的 URL

https://sandbox.itunes.apple.com/verifyReceipt

• 正式环境的 URL

https://buy.itunes.apple.com/verifyReceipt

客户端自己也可以用 Shell 命令测试下看看验证结果，此处的“password”就是上面所说的“App 专用共享密钥”。

/// 沙盒环境
curl -d '{ "exclude-old-transactions": true "password":"yyyy" "receipt-data": "xxxx"}' https://sandbox.itunes.apple.com/verifyReceipt
/// 正式环境
curl -d '{ "exclude-old-transactions": true "password":"yyyy" "receipt-data": "xxxx"}' https://buy.itunes.apple.com/verifyReceipt

验证后 Apple 会返回数据，从中可以获取 product_id、quantity 等，下面是正确时的返回数据：

{
    "status": 0,
    "environment": "Sandbox",
    "receipt": {
        "receipt_type": "ProductionSandbox",
        "adam_id": 0,
        "app_item_id": 0,
        "bundle_id": "com.xxx.xxxxxx",
        "application_version": "999",
        "download_id": 0,
        "version_external_identifier": 0,
        "receipt_creation_date": "2016-05-26 04:35:08 Etc/GMT",
        "receipt_creation_date_ms": "1464237308000",
        "receipt_creation_date_pst": "2016-05-25 21:35:08 America/Los_Angeles",
        "request_date": "2016-05-26 06:40:32 Etc/GMT",
        "request_date_ms": "1464244832729",
        "request_date_pst": "2016-05-25 23:40:32 America/Los_Angeles",
        "original_purchase_date": "2013-08-01 07:00:00 Etc/GMT",
        "original_purchase_date_ms": "1375340400000",
        "original_purchase_date_pst": "2013-08-01 00:00:00 America/Los_Angeles",
        "original_application_version": "1.0",
        "in_app": [
            {
                "quantity": "1",
                "product_id": "000000",
                "transaction_id": "1000000213676495",
                "original_transaction_id": "1000000213676495",
                "purchase_date": "2016-05-26 04:35:08 Etc/GMT",
                "purchase_date_ms": "1464237308000",
                "purchase_date_pst": "2016-05-25 21:35:08 America/Los_Angeles",
                "original_purchase_date": "2016-05-26 04:35:08 Etc/GMT",
                "original_purchase_date_ms": "1464237308000",
                "original_purchase_date_pst": "2016-05-25 21:35:08 America/Los_Angeles",
                "is_trial_period": "false"
            }
        ]
    }
}

订阅的返回数据：

{
  "environment": "Sandbox",
  "receipt": {
    "receipt_type": "ProductionSandbox",
    "adam_id": 0,
    "app_item_id": 0,
    "bundle_id": "xxx",
    "application_version": "202403271640",
    "download_id": 0,
    "version_external_identifier": 0,
    "receipt_creation_date": "2024-03-27 15:17:27 Etc/GMT",
    "receipt_creation_date_ms": "1711552647000",
    "receipt_creation_date_pst": "2024-03-27 08:17:27 America/Los_Angeles",
    "request_date": "2024-03-27 15:18:10 Etc/GMT",
    "request_date_ms": "1711552690911",
    "request_date_pst": "2024-03-27 08:18:10 America/Los_Angeles",
    "original_purchase_date": "2013-08-01 07:00:00 Etc/GMT",
    "original_purchase_date_ms": "1375340400000",
    "original_purchase_date_pst": "2013-08-01 00:00:00 America/Los_Angeles",
    "original_application_version": "1.0",
    "in_app": [
      {
        "quantity": "1",
        "product_id": "sp_3",
        "transaction_id": "2000000556971707",
        "original_transaction_id": "2000000556971707",
        "purchase_date": "2024-03-27 15:17:26 Etc/GMT",
        "purchase_date_ms": "1711552646000",
        "purchase_date_pst": "2024-03-27 08:17:26 America/Los_Angeles",
        "original_purchase_date": "2024-03-27 15:17:26 Etc/GMT",
        "original_purchase_date_ms": "1711552646000",
        "original_purchase_date_pst": "2024-03-27 08:17:26 America/Los_Angeles",
        "expires_date": "2024-03-27 16:17:26 Etc/GMT",
        "expires_date_ms": "1711556246000",
        "expires_date_pst": "2024-03-27 09:17:26 America/Los_Angeles",
        "web_order_line_item_id": "2000000055757881",
        "is_trial_period": "false",
        "is_in_intro_offer_period": "false",
        "in_app_ownership_type": "PURCHASED"
      }
    ]
  },
  "latest_receipt_info": [
    {
      "quantity": "1",
      "product_id": "sp_3",
      "transaction_id": "2000000556971707",
      "original_transaction_id": "2000000556971707",
      "purchase_date": "2024-03-27 15:17:26 Etc/GMT",
      "purchase_date_ms": "1711552646000",
      "purchase_date_pst": "2024-03-27 08:17:26 America/Los_Angeles",
      "original_purchase_date": "2024-03-27 15:17:26 Etc/GMT",
      "original_purchase_date_ms": "1711552646000",
      "original_purchase_date_pst": "2024-03-27 08:17:26 America/Los_Angeles",
      "expires_date": "2024-03-27 16:17:26 Etc/GMT",
      "expires_date_ms": "1711556246000",
      "expires_date_pst": "2024-03-27 09:17:26 America/Los_Angeles",
      "web_order_line_item_id": "2000000055757881",
      "is_trial_period": "false",
      "is_in_intro_offer_period": "false",
      "in_app_ownership_type": "PURCHASED",
      "subscription_group_identifier": "21443081"
    }
  ],
  "latest_receipt": "xxx",
  "pending_renewal_info": [
    {
      "auto_renew_product_id": "sp_3",
      "product_id": "sp_3",
      "original_transaction_id": "2000000556971707",
      "auto_renew_status": "1"
    }
  ],
  "status": 0
}

Verify your receipt first with the production URL; then verify with the sandbox URL if you receive a 21007 status code. This approach ensures you don’t have to switch between URLs while your app is in testing, in review by App Review, or live in the App Store.

苹果官方文档提到，如果正式环境验证凭证失败，收到错误码 21007，则代表该凭证是沙盒环境的，需要去沙盒环境验证凭证。同理，沙盒环境也有对应的错误码。这样才能不影响审核期间、测试期间的使用。

2.5 丢单处理

参考官方文档，在 didFinishLaunchingWithOptions 的时候，调用 completeTransactions 操作。
具体处理逻辑，不同的支付流程对应不同的处理方式。很多文章都有提到，这里就不赘述了。

建议设计支付流程时，等用户支付后才去调用服务器。如果在用户点击购买时，调用服务器创建自己的订单，再支付，再通知服务器，这样流程长了，会更容易出现问题。

2.6 自动续订的订阅商品的处理

在苹果后台设置“App Store 服务器通知”，在 appstoreconnect.apple.com - App 信息 设置，包括生产环境和测试环境。
服务器在配置的 URL 中进行逻辑处理。

2.7 多 App 账号同个苹果账号的权益处理/恢复订阅

权益跨设备、跨 App 账号使用，是应用内购买常见且复杂的问题。

2.7.1 权益归属

如同其他文章所述，苹果期望权益是归属于苹果账号的，登录同个苹果账号应该享用同样的已购买的权益。而实际设计时，可能更期望权益归属于 App 账号的，同个 App 账号在不同设备上登录可以享用相同的已购买的权益。

不同的产品会设计不一样的逻辑，跟账号体系关联。

2.7.2 账号体系设计

在近期提审时，发现苹果审核指出，购买跟账号无关的商品时不能要求用户注册登录，也就是需要支持游客（相对于 App 的账号体系）购买。即使解释这种操作是为了方便用户跨设备使用也无济于事。这使得整个账号体系设计更复杂。

于是整个账号体系存在三层：设备、Apple 账号、App 账号，需要进行各种登录和绑定情况的处理。

2.7.3 订阅

主要有几种情况需要注意：

image.png

账号b点击订阅，再点击“已经订阅过”的弹窗上的“好”操作，此时权益其实还在账号a上，需要做处理。另外就是自动续订触发时，需要处理续订到哪个 App 账号上。

三、测试

testing_in-app_purchases_with_sandbox

对于自动续订的订阅商品的情况：

如果当前苹果账号已经订阅，苹果会弹出弹窗“已经订阅过”，弹窗上有两个按钮“管理”和“好”，点击“管理”会跳转管理页面，并返回失败（支付取消）结果；点击“好”，如果距离自动续订时间小于 24 小时，会生成新交易号；如果大于则会返回旧的交易号，属于重复订阅的情况。

如果此时再点击“订阅‘，不会再弹窗，而是直接返回成功，效果同上点击”好“。

下面是在沙盒环境下的真机测试截图（“测试”是所填写的产品名称，未登录Apple ID时会提示登录，已登录时会提示输入密码/Touch ID）：

IMG_6816.PNG

IMG_6814.PNG

四、参考文档

• Apple Documentation Storekit
• Validating Receipts With the App Store
• testing_in-app_purchases_with_sandbox

-END-
欢迎到我的博客交流：http://zackzheng.info