```
public final class SubscriptionOffer

                    
```
Standardized subscription discount/promotional offer. Provides a unified interface for subscription offers across iOS and Android.
Both platforms support subscription offers with different implementations:
- iOS: Introductory offers, promotional offers with server-side signatures
- Android: Offer tokens with pricing phases

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public class`	`SubscriptionOffer.Companion`

Field Summary

Fields
Modifier and Type	Field	Description
`private final String`	`basePlanIdAndroid`
`private final String`	`currency`
`private final String`	`displayPrice`
`private final String`	`id`
`private final InstallmentPlanDetailsAndroid`	`installmentPlanDetailsAndroid`
`private final String`	`keyIdentifierIOS`
`private final String`	`localizedPriceIOS`
`private final String`	`nonceIOS`
`private final Integer`	`numberOfPeriodsIOS`
`private final List<String>`	`offerTagsAndroid`
`private final String`	`offerTokenAndroid`
`private final PaymentMode`	`paymentMode`
`private final SubscriptionPeriod`	`period`
`private final Integer`	`periodCount`
`private final Double`	`price`
`private final PricingPhasesAndroid`	`pricingPhasesAndroid`
`private final String`	`signatureIOS`
`private final Double`	`timestampIOS`
`private final DiscountOfferType`	`type`

Constructor Summary

Constructors
Constructor	Description
SubscriptionOffer(String basePlanIdAndroid, String currency, String displayPrice, String id, InstallmentPlanDetailsAndroid installmentPlanDetailsAndroid, String keyIdentifierIOS, String localizedPriceIOS, String nonceIOS, Integer numberOfPeriodsIOS, List<String> offerTagsAndroid, String offerTokenAndroid, PaymentMode paymentMode, SubscriptionPeriod period, Integer periodCount, Double price, PricingPhasesAndroid pricingPhasesAndroid, String signatureIOS, Double timestampIOS, DiscountOfferType type)

Method Summary

Modifier and Type	Method	Description
`final String`	`getBasePlanIdAndroid()`	Android Base plan identifier.
`final String`	`getCurrency()`	Currency code (ISO 4217, e.g.
`final String`	`getDisplayPrice()`	Formatted display price string (e.g., "$9.
`final String`	`getId()`	Unique identifier for the offer.
`final InstallmentPlanDetailsAndroid`	`getInstallmentPlanDetailsAndroid()`	Android Installment plan details for this subscription offer.
`final String`	`getKeyIdentifierIOS()`	iOS Key identifier for signature validation.
`final String`	`getLocalizedPriceIOS()`	iOS Localized price string.
`final String`	`getNonceIOS()`	iOS Cryptographic nonce (UUID) for signature validation.
`final Integer`	`getNumberOfPeriodsIOS()`	iOS Number of billing periods for this discount.
`final List<String>`	`getOfferTagsAndroid()`	Android List of tags associated with this offer.
`final String`	`getOfferTokenAndroid()`	Android Offer token required for purchase.
`final PaymentMode`	`getPaymentMode()`	Payment mode during the offer period
`final SubscriptionPeriod`	`getPeriod()`	Subscription period for this offer
`final Integer`	`getPeriodCount()`	Number of periods the offer applies
`final Double`	`getPrice()`	Numeric price value
`final PricingPhasesAndroid`	`getPricingPhasesAndroid()`	Android Pricing phases for this subscription offer.
`final String`	`getSignatureIOS()`	iOS Server-generated signature for promotional offer validation.
`final Double`	`getTimestampIOS()`	iOS Timestamp when the signature was generated.
`final DiscountOfferType`	`getType()`	Type of subscription offer (Introductory or Promotional)
`final Map<String, Object>`	`toJson()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SubscriptionOffer
```
SubscriptionOffer(String basePlanIdAndroid, String currency, String displayPrice, String id, InstallmentPlanDetailsAndroid installmentPlanDetailsAndroid, String keyIdentifierIOS, String localizedPriceIOS, String nonceIOS, Integer numberOfPeriodsIOS, List<String> offerTagsAndroid, String offerTokenAndroid, PaymentMode paymentMode, SubscriptionPeriod period, Integer periodCount, Double price, PricingPhasesAndroid pricingPhasesAndroid, String signatureIOS, Double timestampIOS, DiscountOfferType type)
```
- Method Detail
  - getBasePlanIdAndroid
```
 final String getBasePlanIdAndroid()
```
    Android Base plan identifier. Identifies which base plan this offer belongs to.
  - getCurrency
```
 final String getCurrency()
```
    Currency code (ISO 4217, e.g., "USD")
  - getDisplayPrice
```
 final String getDisplayPrice()
```
    Formatted display price string (e.g., "$9.99/month")
  - getId
```
 final String getId()
```
    Unique identifier for the offer.
    iOS: Discount identifier from App Store Connect
    Android: offerId from ProductSubscriptionAndroidOfferDetails
  - getInstallmentPlanDetailsAndroid
```
 final InstallmentPlanDetailsAndroid getInstallmentPlanDetailsAndroid()
```
    Android Installment plan details for this subscription offer. Only set for installment subscription plans; null for non-installment plans. Available in Google Play Billing Library 7.0+
  - getKeyIdentifierIOS
```
 final String getKeyIdentifierIOS()
```
    iOS Key identifier for signature validation. Used with server-side signature generation for promotional offers.
  - getLocalizedPriceIOS
```
 final String getLocalizedPriceIOS()
```
    iOS Localized price string.
  - getNonceIOS
```
 final String getNonceIOS()
```
    iOS Cryptographic nonce (UUID) for signature validation. Must be generated server-side for each purchase attempt.
  - getNumberOfPeriodsIOS
```
 final Integer getNumberOfPeriodsIOS()
```
    iOS Number of billing periods for this discount.
  - getOfferTagsAndroid
```
 final List<String> getOfferTagsAndroid()
```
    Android List of tags associated with this offer.
  - getOfferTokenAndroid
```
 final String getOfferTokenAndroid()
```
    Android Offer token required for purchase. Must be passed to requestPurchase() when purchasing with this offer.
  - getPaymentMode
```
 final PaymentMode getPaymentMode()
```
    Payment mode during the offer period
  - getPeriod
```
 final SubscriptionPeriod getPeriod()
```
    Subscription period for this offer
  - getPeriodCount
```
 final Integer getPeriodCount()
```
    Number of periods the offer applies
  - getPrice
```
 final Double getPrice()
```
    Numeric price value
  - getPricingPhasesAndroid
```
 final PricingPhasesAndroid getPricingPhasesAndroid()
```
    Android Pricing phases for this subscription offer. Contains detailed pricing information for each phase (trial, intro, regular).
  - getSignatureIOS
```
 final String getSignatureIOS()
```
    iOS Server-generated signature for promotional offer validation. Required when applying promotional offers on iOS.
  - getTimestampIOS
```
 final Double getTimestampIOS()
```
    iOS Timestamp when the signature was generated. Used for signature validation.
  - getType
```
 final DiscountOfferType getType()
```
    Type of subscription offer (Introductory or Promotional)
  - toJson
```
 final Map<String, Object> toJson()
```

Class SubscriptionOffer

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

SubscriptionOffer

Method Detail

getBasePlanIdAndroid

getCurrency

getDisplayPrice

getId

getInstallmentPlanDetailsAndroid

getKeyIdentifierIOS

getLocalizedPriceIOS

getNonceIOS

getNumberOfPeriodsIOS

getOfferTagsAndroid

getOfferTokenAndroid

getPaymentMode

getPeriod

getPeriodCount

getPrice

getPricingPhasesAndroid

getSignatureIOS

getTimestampIOS

getType

toJson