---
title: PurchaseIntent
framework: storekit
role: symbol
role_heading: Structure
path: storekit/purchaseintent
---

# PurchaseIntent

An instance that emits purchase intents, which indicate that the customer initiated a purchase outside of your app, for your app to complete.

## Declaration

```swift
struct PurchaseIntent
```

## Mentioned in

Supporting win-back offers in your app Supporting promoted In-App Purchases in your app Promoting In-App Purchases

## Overview

Overview Using PurchaseIntent is required in the following cases: If you promote in-app purchases on the App Store If you turn off the Streamlined Purchasing setting in App Store Connect and use win-back offers or contingent pricing You set up these offers and settings in App Store Connect. For more information, see Promote in-app purchases, Set up win-back offers, and Manage Streamlined Purchasing. important: To enable promoted in-app purchases, your app must use either PurchaseIntent (starting in iOS 16.4) or paymentQueue(_:shouldAddStorePayment:for:) (starting in iOS 11). Don’t use both at the same time. If necessary, use conditional compilation to identify the OS version the app is running in. For more information, see Running code on a specific platform or OS version. When a customer selects a promoted product on the App Store or a win-back offer outside of your app, it initiates a purchase that they complete in your app. If they don’t have your app installed, the system prompts them to download it. After the app downloads, the transaction continues in the app, which receives a purchase intent from the intents sequence. The purchase intent identifies the product the customer selected. To enable customers to complete the purchase, call purchase(options:) on this product instance. The following example code receives the purchase intent, and calls a method to complete the purchase workflow: func purchaseProduct(_ product: Product) async {     // Complete the purchase workflow.     do {         try await product.purchase()     }     catch {         // Add your error handling here.     }     // Add your remaining purchase workflow here. }

for await purchaseIntent in PurchaseIntent.intents {     // Complete the purchase workflow.     await purchaseProduct(purchaseIntent.product) }

For more information, see Supporting promoted In-App Purchases in your app and Supporting win-back offers in your app. In Mac apps built with Mac Catalyst, this instance doesn’t emit purchase intents for promoted in-app purchases because the Mac App Store doesn’t support this feature. note: PurchaseIntent and promoted in-app purchases aren’t available to compatible iPad or iPhone apps running in visionOS.

## Topics

### Identifying the product

- [id](storekit/purchaseintent/id.md)
- [product](storekit/purchaseintent/product.md)

### Getting purchase intents

- [intents](storekit/purchaseintent/intents.md)
- [PurchaseIntent.PurchaseIntents](storekit/purchaseintent/purchaseintents.md)

### Identifying the offer

- [offer](storekit/purchaseintent/offer.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Identifiable](swift/identifiable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Promoted In-App Purchases

- [Supporting promoted In-App Purchases in your app](storekit/supporting-promoted-in-app-purchases-in-your-app.md)
- [Product.PromotionInfo](storekit/product/promotioninfo.md)
- [Testing promoted In-App Purchases](storekit/testing-promoted-in-app-purchases.md)