Paywall callbacks not being called on iOS

[MrJohn10]

On iOS the onPurchaseStarted and onPurchaseCompleted are not being called.
On Android they work as expected.

code sample:

return PaywallOptions(
        dismissRequest = {
            onDismiss()
        }
    ) {
        var productPrice: Long? = null
        var isProductSubscription: Boolean? = null

        shouldDisplayDismissButton = displayDismissButton

        listener = object : PaywallListener {
            override fun onPurchaseCompleted(
                customerInfo: CustomerInfo,
                storeTransaction: StoreTransaction
            ) {
                analytics.trackEvent(
                    actionName = "Paywall Callback",
                    properties = mapOf(
                        "value" to "purchase completed",
                        "ingress" to ingress,
                        "product_id" to (storeTransaction.productIds.firstOrNull()
                            ?: "unknown"),
                    )
                )

                // we only show app review when user bought product not for free, or trial
                if (((productPrice ?: 0L) > 0L) || isProductSubscription == true) {
                    requestReview("Purchase Completed")
                }

                // the paywall calls navigate back itself
            }

version: purchases-kmp = "2.10.2+17.55.1"

[rickvdl]

Hi @MrJohn10 thanks for your report! We'll take a look and get back to you shortly. Thanks!

[JayShortway]

Hi @MrJohn10, could you check if this issue happens on 3.0.0-beta.1 too?

[JayShortway]

Also @MrJohn10, are you seeing this on a specific iOS version?

[MrJohn10]

Tested myself on iOS 26.3.1
Also happens in production - I don't see events in my analytics (only the Android ones).
I will test the beta version later.

[JayShortway]

That's helpful, thank you!

[hellosagar]

👋 Confirming this is hitting paying users in production on purchases-kmp = "2.10.2+17.55.1".

Symptom for the end user: they tap "Buy" → Apple Pay / Face ID confirms → checkmark appears (so the StoreKit transaction completed and the card was charged) → paywall just stays on screen indefinitely. No onPurchaseStarted, no onPurchaseCompleted, no error. The user has to manually tap the X to dismiss, but at that point the entitlement was never recorded locally so they re-trigger the paywall on the next gated tap. End-user-visible result: "I paid for lifetime but the app doesn't recognize it" — only resolved by force-quit + reopen, which lets getCustomerInfo re-fetch on cold start.

Root cause in 2.10.2 source: the regular Paywall(options) composable goes through UIKitPaywall.kt with footer = false, which uses IosPaywallProxyDelegate (in UIKitPaywall.kt:131-184). That delegate implements RCPaywallViewControllerDelegateWrapperProtocol but does not override paywallViewController:didFinishPurchasingWithCustomerInfo:transaction:. Compare with IosPaywallDelegate in PaywallOptionsKtx.kt:40-49 (used only for the footer path), which does implement that bridge. So onPurchaseCompleted is structurally unreachable on iOS for the non-footer Paywall.

Workaround we shipped: registered a singleton PurchasesDelegate via Purchases.sharedInstance.delegate = bridge (held strongly so iOS doesn't dealloc it). In onCustomerInfoUpdated, we mirror entitlements[ID]?.isActive into our local DataStore. The paywall route observes that DataStore flow with a LaunchedEffect and treats false → true as a purchase-success signal, navigating away. Cross-platform, doesn't depend on onPurchaseCompleted firing.

[MrJohn10]

In my case the paywall is being closed automatically after user completes the purchase. This is my full code.

fun paywallOptions(
    analytics: AnalyticsRepository,
    onDismiss: () -> Unit,
    ingress: String,
    requestReview: (String) -> Unit,
    displayDismissButton: Boolean
): PaywallOptions {
    return PaywallOptions(
        dismissRequest = {
            onDismiss()
        }
    ) {
        var productPrice: Long? = null
        var isProductSubscription: Boolean? = null

        shouldDisplayDismissButton = displayDismissButton

        listener = object : PaywallListener {
            override fun onPurchaseCompleted(
                customerInfo: CustomerInfo,
                storeTransaction: StoreTransaction
            ) {
                analytics.trackEvent(
                    actionName = "Paywall Callback",
                    properties = mapOf(
                        "value" to "purchase completed",
                        "ingress" to ingress,
                        "product_id" to (storeTransaction.productIds.firstOrNull()?.toString()
                            ?: "unknown"),
                    )
                )

                // we only show app review when user bought product not for free, or trial
                if (((productPrice ?: 0L) > 0L) || isProductSubscription == true) {
                    requestReview("Purchase Completed")
                }

                // the paywall calls navigate back itself
            }

            override fun onPurchaseStarted(rcPackage: Package) {
                isProductSubscription =
                    rcPackage.storeProduct.category == ProductCategory.SUBSCRIPTION
                productPrice = rcPackage.storeProduct.price.amountMicros
                analytics.trackEvent(...)
                super.onPurchaseStarted(rcPackage)
            }

            override fun onPurchaseError(error: PurchasesError) {
                analytics.trackEvent(...)
                super.onPurchaseError(error)
            }

            override fun onPurchaseCancelled() {
                analytics.trackEvent(...)
                super.onPurchaseCancelled()
            }

            override fun onRestoreCompleted(customerInfo: CustomerInfo) {
                analytics.trackEvent(...)
                super.onRestoreCompleted(customerInfo)
                onDismiss()
            }
        }
    }
}

I also don't have any issues with updating the user entitlements.

Purchases.sharedInstance.delegate = object : PurchasesDelegate {
            override fun onCustomerInfoUpdated(customerInfo: CustomerInfo) {
                onReceived(customerInfo)
            }
}

[hellosagar]

Thanks for the context — useful distinction. For us the symptom was worse: paywall stayed visible after purchase (didn't auto-dismiss) on iPhone 16 / iOS 18. Likely because we hadn't registered a PurchasesDelegate either, so neither the listener callbacks nor RC's internal "fresh CustomerInfo" path was reaching our app state. Adding the delegate on top of the existing listener (per your snippet) papers over both.

Sounds like the underlying SDK gap is the same — IosPaywallProxyDelegate missing the didFinishPurchasing bridge — but the user-facing symptom depends on whether the host has a delegate registered elsewhere.