iOS getPromotedProductIOS

Get the currently promoted product from App Store (iOS 15+).

Reads the product surfaced via App Store promoted IAP campaigns. OpenIAP listens to PurchaseIntent.intents on iOS 16.4+ and uses SKPaymentTransactionObserver.shouldAddStorePayment only on iOS 15–16.3. When a purchase intent contains an externally redeemed win-back offer, OpenIAP preserves that exact offer for the next matching requestPurchase call unless the caller supplies an explicit win-back or promotional offer. See the Apple StoreKit reference.

Signature

swift

func getPromotedProductIOS() async throws -> ProductIOS?

Returns#

Promise<ProductIOS | null> — the App Store-promoted product, or null if no campaign is currently queued.

Example

swift

let product = try await OpenIapModule.shared.getPromotedProductIOS()