Class

SKPaymentQueue

A queue of payment transactions to be processed by the App Store.

Declaration

@interface SKPaymentQueue : NSObject

Overview

The payment queue communicates with the App Store and presents a user interface so that the user can authorize payment. The contents of the queue are persistent between launches of your app.

To process a payment, first add at least one observer object (SKPaymentTransactionObserver) to the queue (see addTransactionObserver:). Then, add a payment object (SKPayment) for the item the user wants to purchase. Each time you add a payment object, the queue creates a transaction object (SKPaymentTransaction) to process that payment and enqueues it to be processed. After payment is fulfilled, the queue updates the transaction object and then calls any observer objects to provide them the updated transaction. Your observer should process the transaction and then remove it from the queue.

The exact mechanism you use to process a processed transaction depends on the design of your app and the product being purchased. Here are a few common examples:

  • If the product is a feature already built into your app, your app enables the feature to process the transaction.

  • If the product includes downloadable content provided by the App Store, your app retrieves the SKDownload objects from the transaction and ask the payment queue to download them. You provide the actual content files to be served by the App Store to App Store Connect when you create the product information.

  • If the product represents downloadable content provided by your own server, your app might open a network connection to your server and download the content from there.

For more information on designing the payment processing portion of your app, see In-App Purchase Programming Guide.

Topics

Determining Whether the User Can Make Payments

+ canMakePayments

Indicates whether the user is allowed to make payments.

Determining Store Content

storefront

The current App Store storefront for the payment queue.

Beta

Getting the Queue

+ defaultQueue

Returns the default payment queue instance.

Adding and Removing the Observer

- addTransactionObserver:

Adds an observer to the payment queue.

- removeTransactionObserver:

Removes an observer from the payment queue.

Managing Transactions

delegate

A delegate that provides information needed to complete transactions.

Beta
transactions

Returns an array of pending transactions.

- addPayment:

Adds a payment request to the queue.

- finishTransaction:

Completes a pending transaction.

Restoring Purchases

- restoreCompletedTransactions

Asks the payment queue to restore previously completed purchases.

- restoreCompletedTransactionsWithApplicationUsername:

Asks the payment queue to restore previously completed purchases, providing an opaque identifier for the user’s account.

Downloading Content

- startDownloads:

Adds a set of downloads to the download list.

- cancelDownloads:

Removes a set of downloads from the download list.

- pauseDownloads:

Pauses a set of downloads.

- resumeDownloads:

Resumes a set of downloads.

Relationships

Inherits From

See Also

Initiating a Purchase

Requesting a Payment from the App Store

Submit a payment request to the App Store when a user selects a product to buy.

SKPayment

A request to the App Store to process payment for additional functionality offered by your app.

SKMutablePayment

A mutable request to the App Store to process payment for additional functionality offered by your app.

SKPaymentDiscount

The signed discount applied to a payment.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software