onPurchaseComplete

Signature

@discardableResult
public func onPurchaseComplete(
    _ handler: @escaping (StoreKit.Transaction, String) async -> Void
) -> Encore

Parameters

Parameter	Type	Description
`handler`	`(Transaction, String) async -> Void`	Closure receiving the verified StoreKit `Transaction` and `productId`

When It Fires

onPurchaseComplete fires only when:

No onPurchaseRequest handler is registered
Encore successfully completes a native StoreKit 2 purchase
The transaction is verified and finished

It does not fire when:

An onPurchaseRequest handler is set (the delegated handler takes full responsibility)
The user cancels the purchase
The purchase fails or is pending

Usage

Use this callback to sync StoreKit transactions with subscription managers that don’t automatically detect external purchases.

Adapty

Encore.shared.onPurchaseComplete { transaction, productId in
    try? await Adapty.reportTransaction(transaction)
}

Qonversion

Encore.shared.onPurchaseComplete { transaction, productId in
    Qonversion.shared().syncStoreKit2Purchases()
}

RevenueCat and Superwall auto-detect StoreKit transactions when configured in observer mode. They do not need onPurchaseComplete.

Chaining

Encore.shared
    .onPurchaseComplete { transaction, productId in
        try? await Adapty.reportTransaction(transaction)
    }
    .onPassthrough { placementId in
        router.handleOriginalAction(for: placementId)
    }

Behavior

Survives reset() — app-level infrastructure, not user state
Last handler wins — setting a new handler replaces the previous one
Main actor — called on the main thread

Getting Started

iOS SDK

Android SDK

Flutter SDK

React Native SDK

Capacitor SDK

Kotlin Multiplatform SDK

Web SDK

Integration Patterns

Automated Messaging

Offer Catalog

Offers API

Signature

Parameters

When It Fires

Usage

Adapty

Qonversion

Chaining

Behavior

​Signature

​Parameters

​When It Fires

​Usage

​Adapty

​Qonversion

​Chaining

​Behavior

Signature

Parameters

When It Fires

Usage

Adapty

Qonversion

Chaining

Behavior