admanagekit-billing/com.i2hammad.admanagekit.billing/OneTimeOfferInfo

OneTimeOfferInfo

data class OneTimeOfferInfo(val productId: String, val offerId: String?, val purchaseOptionId: String?, val offerToken: String, val offerTags: List<String>, val formattedPrice: String, val priceMicros: Long, val currencyCode: String, val fullPriceMicros: Long?, val discountPercentage: Int?, val discountAmountMicros: Long?, val formattedDiscountAmount: String?, val discountCurrencyCode: String?, val rentalPeriod: String?, val rentalExpirationPeriod: String?, val preorderReleaseTimeMillis: Long, val preorderPresaleEndTimeMillis: Long, val maximumQuantity: Int, val remainingQuantity: Int, val validFromMillis: Long, val validUntilMillis: Long, val raw: ProductDetails.OneTimePurchaseOfferDetails)

Typed view over a one-time product offer (ProductDetails.OneTimePurchaseOfferDetails), surfacing the Play Billing 9 features — discounts, rentals, pre-orders and limited quantity — as flat fields for easy UI binding.

Play Billing 9 lets a single one-time product carry multiple offers (a full price plus, say, a 30%-off launch discount). Older code paths that call ProductDetails.getOneTimePurchaseOfferDetails only ever see one of them; use AppPurchase.getOneTimeOffers to enumerate all of them and AppPurchase.purchase with an explicit offer token to buy a specific one.

Obtain instances via AppPurchase.getOneTimeOffers or AppPurchase.getOneTimeOffer — do not construct directly.

Since

4.4.0

Constructors

OneTimeOfferInfo

constructor(productId: String, offerId: String?, purchaseOptionId: String?, offerToken: String, offerTags: List<String>, formattedPrice: String, priceMicros: Long, currencyCode: String, fullPriceMicros: Long?, discountPercentage: Int?, discountAmountMicros: Long?, formattedDiscountAmount: String?, discountCurrencyCode: String?, rentalPeriod: String?, rentalExpirationPeriod: String?, preorderReleaseTimeMillis: Long, preorderPresaleEndTimeMillis: Long, maximumQuantity: Int, remainingQuantity: Int, validFromMillis: Long, validUntilMillis: Long, raw: ProductDetails.OneTimePurchaseOfferDetails)

Types

Companion

object Companion

Properties

currencyCode

val currencyCode: String

ISO-4217 currency code (e.g. "USD").

discountAmountMicros

val discountAmountMicros: Long?

Absolute discount amount in micros, or null when Play reports a percentage instead.

discountCurrencyCode

val discountCurrencyCode: String?

ISO-4217 currency of the absolute discount amount, or null.

discountPercentage

val discountPercentage: Int?

Percentage discount configured in Play Console, or null when not a discount offer.

effectiveDiscountPercent

val effectiveDiscountPercent: Int

Whole-percent discount against fullPriceMicros. Prefers the percentage Play reports; otherwise derives it from the full and actual prices. Returns 0 when this offer is not a discount.

formattedDiscountAmount

val formattedDiscountAmount: String?

Locale-formatted absolute discount amount, or null.

formattedPrice

val formattedPrice: String

Locale-formatted price the user pays (e.g. "$6.99").

fullPriceMicros

val fullPriceMicros: Long?

Undiscounted list price in micros when this offer is a discount, or null when the offer has no strike-through price.

isDiscounted

val isDiscounted: Boolean

true when this offer is priced below the product's list price.