Returns every subscription offer attached to the given product, mapped to a typed OfferInfo (trial / intro / base phases classified by recurrence and price rather than list position).

getOffersByTag

@NonNull

open fun getOffersByTag(productId: String, tag: String): List<OfferInfo>

Returns every offer carrying the given Play Console offer tag.

getOneTimeOffer

@Nullable

open fun getOneTimeOffer(productId: String, offerId: String): OneTimeOfferInfo

Looks up a one-time product offer by its Play Console offer id.

getOneTimeOffers

@NonNull

open fun getOneTimeOffers(productId: String): List<OneTimeOfferInfo>

Returns every offer attached to a one-time (INAPP) product, mapped to a typed OneTimeOfferInfo.

getOwnerIdInapps

open fun getOwnerIdInapps(): List<String>

getOwnerIdSubs

open fun getOwnerIdSubs(): List<PurchaseResult>

getPricePerMonthMicros

open fun getPricePerMonthMicros(productId: String): Long

Recurring price of the base offer normalized to one average month, in micros.

getPricePricingPhaseList

open fun getPricePricingPhaseList(productId: String): List<ProductDetails.PricingPhase>

Returns the full pricing-phase list of the resolved base offer — useful for paywalls that want to render every phase (trial → intro → recurring).

getPriceSub

open fun getPriceSub(productId: String): String

Returns the formatted base (post-trial / post-intro) price for a subscription.

getPriceWithoutCurrency

open fun getPriceWithoutCurrency(productId: String, typeIAP: Int): Double

Raw numeric price (currency unit, not micros) — useful for analytics events that expect a double amount.

getProductDescription

open fun getProductDescription(productId: String): String

Localized Play Console product description.

getProductDetails

open fun getProductDetails(productId: String): ProductDetails

Escape hatch: returns the raw ProductDetails for callers that need fields not surfaced by the typed helpers (e.g.

getProductName

open fun getProductName(productId: String): String

Clean Play Console product name (without the app-name suffix).

getProductTitle

open fun getProductTitle(productId: String): String

Play Console title (includes the app name suffix Play appends, e.g.

getPurchaseCategory

open fun getPurchaseCategory(productId: String): PurchaseItem.PurchaseCategory

Gets the category of a purchased product.

getPurchaseItem

open fun getPurchaseItem(productId: String): PurchaseItem

Gets the PurchaseItem configuration for a product ID.

getSavingsPercent

open fun getSavingsPercent(baseProductId: String, comparedProductId: String): Int

Whole-percent saving of comparedProductId against baseProductId, normalized to a common monthly cadence.

getSubscription

@Nullable

open fun getSubscription(subscriptionId: String): PurchaseResult

Gets the subscription result for a specific product.

getSubscriptionExpiryTime

open fun getSubscriptionExpiryTime(subscriptionId: String): Long

Gets the subscription expiry time in milliseconds.

getSubscriptionExpiryTimeFormatted

open fun getSubscriptionExpiryTimeFormatted(subscriptionId: String): String

Gets the subscription expiry time as a formatted string.

open fun getSubscriptionExpiryTimeFormatted(subscriptionId: String, pattern: String): String

Gets the subscription expiry time as a formatted string with custom pattern.

getSubscriptionRemainingDays

open fun getSubscriptionRemainingDays(subscriptionId: String): Int

Gets the remaining days until subscription expiry.

getSubscriptionState

open fun getSubscriptionState(subscriptionId: String): PurchaseResult.SubscriptionState

Gets the subscription state for a specific subscription.

getTrialOffer

@Nullable

open fun getTrialOffer(productId: String): OfferInfo

Returns the first offer on this subscription that contains a free-trial phase, or null if no offer has a trial.

getUnfetchedProducts

@NonNull

open fun getUnfetchedProducts(): List<UnfetchedProduct>

Returns the products Play declined to return details for during the most recent query of each type.

handlePurchase

open fun handlePurchase(purchase: Purchase)

hasFreeTrial

open fun hasFreeTrial(productId: String): Boolean

Whether any offer on this subscription includes a free-trial phase (priceAmountMicros == 0 with FINITE_RECURRING).

hasIntroductoryPrice

open fun hasIntroductoryPrice(productId: String): Boolean

Whether any offer on this subscription has an introductory price phase.

hasLifetimePremium

open fun hasLifetimePremium(): Boolean

Checks if user has a "Lifetime Premium" purchase specifically.

hasLifetimePurchase

open fun hasLifetimePurchase(): Boolean

Checks if user has a lifetime premium purchase.

open fun hasLifetimePurchase(productId: String): Boolean

Checks if a specific product has been purchased and is currently owned.

hasPendingSubscriptionChange

open fun hasPendingSubscriptionChange(): Boolean

Whether any subscription has a plan change the user started but has not paid for yet.

hasRemoveAdsPurchase

open fun hasRemoveAdsPurchase(): Boolean

Checks if user has a "Remove Ads" purchase specifically.

hasSubscriptionCancelled

open fun hasSubscriptionCancelled(): Boolean

Checks if any subscription is cancelled but still has access.

hasSubscriptionOnHold

open fun hasSubscriptionOnHold(): Boolean

Whether any active subscription is in account hold — Play could not charge the user and has suspended the subscription.

initBilling

open fun initBilling(application: Application, purchaseItemList: List<PurchaseItem>)

open fun ~~initBilling~~(application: Application, listINAPId: List<String>, listSubsId: List<String>)

isAvailable

open fun isAvailable(): Boolean

isEligibleForFreeTrial

open fun isEligibleForFreeTrial(productId: String): Boolean

Whether this user can currently start a free trial on this product.

isEligibleForIntroPrice

open fun isEligibleForIntroPrice(productId: String): Boolean

Whether this user can currently claim an introductory price on this product.

isProductDetailsLoaded

open fun isProductDetailsLoaded(productId: String): Boolean

Whether Play returned details for the given product id.

isProductOwned

open fun isProductOwned(productId: String): Boolean

Checks if a specific product is currently owned (purchased and not consumed).

isPurchased

open fun isPurchased(context: Context): Boolean

isSubscribed

open fun isSubscribed(): Boolean

Checks if user has an active subscription (including cancelled but not expired).

open fun isSubscribed(subscriptionId: String): Boolean

Checks if user has a specific active subscription.

isSubscriptionExpired

open fun isSubscriptionExpired(subscriptionId: String): Boolean

Checks if a subscription has expired based on verified expiry time.

purchase

open fun ~~purchase~~(activity: Activity)

open fun purchase(activity: Activity, @NonNull offer: OneTimeOfferInfo): String

Launches the purchase flow for the exact one-time offer described by offer.

open fun purchase(activity: Activity, productId: String): String

Launches the purchase flow for a product, letting the library pick the offer (the configured trial offer if any, otherwise Play's last offer).

open fun purchase(activity: Activity, productId: String, @Nullable offerToken: String): String

Launches the purchase flow for one specific offer of a product.

queryProductDetails

open fun queryProductDetails(productIds: List<String>, productType: String)

refreshPurchases

open fun refreshPurchases()

Refreshes and retrieves all current purchases from Google Play.

open fun refreshPurchases(productType: String)

Refreshes and retrieves current purchases for a specific product type.

setBillingListener

open fun setBillingListener(billingListener: BillingListener)

open fun setBillingListener(billingListener: BillingListener, timeout: Int)

setConsumePurchase

open fun ~~setConsumePurchase~~(consumePurchase: Boolean)

setDebugMode

open fun setDebugMode(debugMode: Boolean)

Enables debug behaviour: registers the legacy test product in initBilling and shows the dev purchase bottom sheet instead of the real billing flow.

setEventConsumePurchaseTest

open fun setEventConsumePurchaseTest(view: View)

setObfuscatedAccountId

open fun setObfuscatedAccountId(@Nullable obfuscatedAccountId: String)

Sets an obfuscated identifier for the user's in-app account, attached to every subsequent billing flow.

setObfuscatedProfileId

open fun setObfuscatedProfileId(@Nullable obfuscatedProfileId: String)

Sets an obfuscated identifier for the user's in-app profile, attached to every subsequent billing flow.

setOfferPersonalized

open fun setOfferPersonalized(offerPersonalized: Boolean)

Declares whether the prices shown to this user were personalized using automated decision-making.

setOldPrice

open fun setOldPrice(oldPrice: String)

setProductDetailsListener

open fun setProductDetailsListener(@Nullable listener: ProductDetailsListener)

Registers a listener for product-details query results, including the products Play could not return.

setPurchase

open fun setPurchase(purchase: Boolean)

setPurchaseHistoryListener

open fun setPurchaseHistoryListener(listener: PurchaseHistoryListener)

Sets a listener to receive purchase history events.

setPurchaseListener

open fun setPurchaseListener(purchaseListener: PurchaseListener)

setSubscriptionVerificationCallback

open fun setSubscriptionVerificationCallback(callback: SubscriptionVerificationCallback)

Sets a callback for server-side subscription verification.

setUpdatePurchaseListener

open fun setUpdatePurchaseListener(listener: UpdatePurchaseListener)

shouldDisableAds

open fun shouldDisableAds(): Boolean

Checks if ads should be disabled based on any purchase type.

showInAppMessages

open fun showInAppMessages(activity: Activity, @Nullable listener: InAppMessageListener)

Shows Google Play's in-app messages for the current user, if any apply.

open fun subscribe(activity: Activity, @NonNull offer: OfferInfo): String

Subscribes to the exact offer described by offer.

open fun subscribe(activity: Activity, subsId: String): String

Subscribes to a product, letting the library pick the offer (the offer whose id matches trialId if configured, otherwise Play's last offer).

open fun subscribe(activity: Activity, subsId: String, @Nullable offerToken: String): String

Subscribes to one specific offer of a subscription product.

updatePurchaseStatus

open fun updatePurchaseStatus()

updateSubscription

open fun updateSubscription(activity: Activity, newSubsId: String, oldPurchaseToken: String, replacementMode: AppPurchase.SubscriptionReplacementMode): String

Upgrades or downgrades a subscription.

open fun updateSubscription(activity: Activity, newSubsId: String, @Nullable offerToken: String, oldPurchaseToken: String, replacementMode: AppPurchase.SubscriptionReplacementMode): String

Upgrades or downgrades a subscription onto one specific offer of the new product.

upgradeSubscription

open fun upgradeSubscription(activity: Activity, newSubsId: String): String

Upgrades a subscription to a higher tier.

verifyAllSubscriptions

open fun verifyAllSubscriptions(listener: AppPurchase.SubscriptionVerificationListener)

Verifies all active subscriptions with your backend server.

verifyPurchased

open fun verifyPurchased(isCallback: Boolean)

verifySubscription

open fun verifySubscription(subscriptionId: String, listener: AppPurchase.SubscriptionVerificationListener)

Verifies a subscription with your backend server to get the expiry date.

willSubscriptionsRenew

open fun willSubscriptionsRenew(): Boolean

Checks if all subscriptions will auto-renew.