Skip to main content

​
Signature

fun onPurchaseComplete(
    handler: suspend (result: BillingPurchaseResult, productId: String) -> Unit
): Encore

​
Parameters

ParameterTypeDescription
handlersuspend (BillingPurchaseResult, String) -> UnitSuspend function receiving the BillingPurchaseResult and productId

​
BillingPurchaseResult

data class BillingPurchaseResult(
    val productId: String,
    val purchaseToken: String,
    val orderId: String?,
)

​
When It Fires

onPurchaseComplete fires only when:
  1. No onPurchaseRequest handler is registered
  2. Encore successfully completes a native Play Billing purchase
  3. The purchase is acknowledged
It does not fire when:
  • An onPurchaseRequest handler is set
  • The user cancels the purchase
  • The purchase fails

​
Usage

​
Adapty

Encore.shared.onPurchaseComplete { result, productId ->
    Adapty.reportTransaction(result.purchaseToken)
}

​
Qonversion

Encore.shared.onPurchaseComplete { result, productId ->
    Qonversion.shared().syncStoreKit2Purchases()
}
RevenueCat and Superwall auto-detect Play Billing transactions when configured in observer mode. They do not need onPurchaseComplete.

​
Chaining

Encore.shared
    .onPurchaseComplete { result, productId ->
        Adapty.reportTransaction(result.purchaseToken)
    }
    .onPassthrough { placementId ->
        handleOriginalAction(placementId)
    }

​
Behavior

  • Survives reset() — app-level infrastructure, not user state
  • Last handler wins — setting a new handler replaces the previous one