App 内购买项目的原始 API

使用原始 App 内购买项目 API 向用户提供额外的内容和服务。

最新英文文章

Original API for In-App Purchase

概览

借助 App 内购买项目，你可以向用户提供购买 App 内功能和内容的机会。用户可以在 App 内进行购买，也可以直接从 App Store 购买。有关在 App Store 中推广你的产品的信息，请参阅“推广你的 App 内购买项目”。

StoreKit 框架可代表你的 App 连接到 App Store，以提示并安全地处理付款。然后，该框架会通知你的 App，后者便会交付购买的产品。要验证购买，你可以在服务器上通过 App Store 验证收据或在设备端验证收据。对于自动续期订阅，App Store 也可以向你的服务器发出重要订阅事件通知。

图中显示了交易过程中 StoreKit、你的 App、App Store 以及你的服务器之间进行的互动。

在 App Store Connect 中配置 App 内购买项目

要使用 App 内购买项目，你必须首先在 App Store Connect 中配置产品。在开发 App 时，你可以添加或移除产品，也可以完善或重新配置现有的产品。有关更多信息，请参阅“App 内购买项目配置流程”。

你还可以将在多个平台上运行的 App 和 App 内购买项目作为单个购买项目进行提供。有关通用购买的更多信息，请参阅“App Store Connect 帮助”。

了解产品类型

你可提供四种类型的 App 内购买项目：

  • 消耗型项目是一种使用一次之后即失效的项目。用户可以多次购买这类项目。

  • 非消耗型项目是一种用户只需购买一次的项目。这类项目不会过期。

  • 服务或内容的自动续期订阅是一种用户购买一次之后，只要用户不选择取消，就会一直自动续期的项目。

  • 服务或内容的非续期订阅有特定访问时限，不会自动续期。用户可以再次购买这类项目。

你可以使用 StoreKit 跨设备同步和恢复非消耗型项目和自动续期订阅。当用户购买自动续期订阅或非续期订阅时，你的 App 应当让用户能够在所有设备上访问这一订阅，并让用户能够恢复以前购买的项目。

相关主题

基础知识

为付款队列设置交易观察器
通过添加观察器，让你的 App 能够接收和处理交易。
提供、完成和恢复 App 内购买项目
在你的 App 中获取、完成和恢复交易。
class SKPaymentQueue
由 App Store 处理的付款交易队列。
protocol SKPaymentTransactionObserver
处理交易、解锁已购功能和延续推广 App 内购买项目的一组方法。
protocol SKPaymentQueueDelegate
为提供完成交易所需信息而实现的协议。
class SKRequest
向 App Store 提交的请求的抽象类。

产品信息

载入 App 内产品标识符
载入 App 内产品的唯一标识符，以便从 App Store 检索产品信息。
从 App Store 获取产品信息
检索 App 中所售产品的最新信息来向用户显示。
class SKProductsRequest
这个对象可以从 App Store 检索指定产品列表的本地化信息。
class SKProductsResponse
App Store 对产品列表信息请求的响应。
class SKProduct
以前在 App Store Connect 中注册的产品的相关信息。

商店

class SKStorefront
含有 Apple App Store 商店的位置和唯一标识符的对象。

购买项目

向 App Store 请求付款
当用户选择购买产品时，会向 App Store 提交付款请求。
处理交易
注册交易队列观察器，以获取并处理来自 App Store 的交易更新。
class SKPayment
向 App Store 提交的请求，用于处理购买 App 中额外功能的付款。
class SKMutablePayment
向 App Store 提交的可变请求，用于处理购买 App 中额外功能的付款。
class SKPaymentTransaction
付款队列中的对象。

购买验证

选取收据验证方法
选择适用于你 App 的收据验证类型。
通过 App Store 验证收据
在安全的服务器上通过 App Store 验证交易。
var appStoreReceiptURL: URL?
套装的 App Store 收据的文件 URL。
class SKReceiptRefreshRequest
刷新收据的请求，获得用户与你 App 相关的交易。

内容交付

解锁已购买的内容
在验证购买后向用户交付内容。
持久保留购买
保留购买项目的持久记录以根据需要持续提供产品。
完成交易
完成交易继而完成购买流程。
class SKDownload
与产品关联的可下载内容。

退款

处理退款通知
响应用户就消耗型项目、非消耗型项目以及非续期订阅产品申请退款期间创建的通知。

允许访问之前购买的产品

恢复已购买的产品
为用户提供在你的 App 中恢复其购买项目的功能，以确保他们能够继续访问已购买的内容。
class SKReceiptRefreshRequest
刷新收据的请求，获得用户与你 App 相关的交易。
class SKRequest
向 App Store 提交的请求的抽象类。
class SKPaymentTransaction
付款队列中的对象。
func SKTerminateForInvalidReceipt()
如果 App 的使用许可证已过期，则会终止 App。

家人共享

在你的 App 中支持“家人共享”
提供与家庭成员分享订阅内容和非消耗型产品的服务。
var isFamilyShareable: Bool
一个布尔值，用于在 App Store Connect 中表明产品是否可用于“家人共享”。
func paymentQueue(SKPaymentQueue, didRevokeEntitlementsForProductIdentifiers: [String])
告诉观察器，用户不再有权访问一个或多个家人共享购买项目。

订阅

订阅和优惠
通过在 App 内购买的项目，向用户提供额外的限时内容和服务。

推广

推广 App 内购买项目
在你 App 的产品页面上显示你的 App 内购买项目。
测试推广的 App 内购买项目
在 App Store 中上架 App 前，请先测试相关的 App 内购买项目。
class SKProductStorePromotionController
产品推广控制器，用于自定 App 内购买项目在各种设备上的排列顺序和显示状况。

测试 App 内购买项目

使用 Xcode 和沙盒在开发过程中的各个阶段进行测试
通过在整个开发过程中测试代码来验证你的 App 内购买项目的实现。
在 Xcode 中设置 StoreKit 测试
设置测试环境以使用你在本地配置的数据测试 App 内购买项目。
在 Xcode 中测试 App 内购买项目
使用你在本地配置的产品数据测试和调试 App 内购买项目的实现。
使用沙盒测试 App 内购买项目
在沙盒环境中使用真实产品信息和服务器对服务器交易测试你的 App 内购买项目的实施。

错误

处理错误
处理 StoreKit 请求导致的错误。
enum SKError.Code
StoreKit 错误的错误代码。
struct SKError
StoreKit 错误描述、代码和域。
let SKErrorDomain: String
StoreKit 错误的错误域名称。

另请参阅

App 内购买项目

为 App 内购买项目选择 StoreKit API
使用最新 API 支持你的新 App 或现有 App 中的 App 内购买项目，或者对现有 App 使用原始 API。
App 内购买项目
通过使用基于 Swift 的现代界面，向用户提供额外的内容和服务。