Skip to main content

​
Overview

Encore works alongside Qonversion so you can present retention offers at key moments in your app. Since Qonversion doesn’t include a built-in paywall component, you present Encore offers directly using Encore.placement().show().
Qonversion handles subscription management, analytics, and attribution. Encore handles retention offer presentation and purchase delegation.

​
Handle Offer Results

Register handlers at app launch so Encore can delegate purchases to Qonversion.

​
Register onPurchaseRequest

Encore.shared.onPurchaseRequest { productId, placementId in
    try await Qonversion.shared().purchaseProduct(productId: productId)
}
See onPurchaseRequest() for complete API details and examples with other subscription managers.

​
Register onPassthrough

Called when the user dismisses the offer or no offers are available. Use this to resume the user’s original action. 
Encore.shared.onPassthrough { placementId in
    // Resume your original user flow
}

​
Alternative: Automatic StoreKit Purchase

If you don’t set onPurchaseRequest, Encore purchases via native StoreKit 2 automatically. You must manually sync each transaction to Qonversion so it can track entitlements.

​
Setup

  1. Configure Qonversion SDK in analytics mode:
let config = Qonversion.Configuration(projectKey: "YOUR_KEY", launchMode: .analytics)
Qonversion.initWithConfig(config)
  1. Register onPurchaseComplete to sync purchases:
Encore.shared.onPurchaseComplete { transaction, productId in
    Qonversion.shared().syncStoreKit2Purchases()
}

​
Configure Analytics

​
Encore Webhook

Encore uses Apple’s App Store Server Notifications to track subscription lifecycle events and measure offer impact. See Configure Analytics for full setup instructions.
If Qonversion already occupies your primary App Store Server Notifications URL, use the Forward from Your Server option to send notifications to both Qonversion and Encore.

​
Qonversion Webhook

If you’re using the Automatic StoreKit Purchase approach above, you can optionally configure Qonversion to receive App Store Server Notifications as well.
Qonversion’s ASSN V2 webhook is optional — Qonversion can sync transactions without it. However, it improves accuracy for renewal and refund tracking.
In App Store Connect, add the ASSN V2 webhook URL from your Qonversion Dashboard. If Encore is your primary URL, forward notifications to Qonversion from your server.