Package 

Interface SubscriptionResolver

    • Method Summary

      Modifier and Type Method Description
      abstract DeveloperProvidedBillingDetailsAndroid developerProvidedBillingAndroid() Fires when a user selects developer billing in an External Payments or Billing Choice flow (Android only).
      abstract String promotedProductIOS() Fires when the App Store surfaces a promoted product (iOS only)
      abstract PurchaseError purchaseError() Fires when a purchase fails or is cancelled
      abstract Purchase purchaseUpdated(PurchaseUpdatedListenerOptions options) Fires when a purchase completes successfully or a pending purchase resolves Options can opt iOS listeners into duplicate StoreKit transaction replays for diagnostics; default listeners receive one event per transaction ID during a single connection session.
      abstract Purchase subscriptionBillingIssue() Fires when a subscription enters a billing-issue state that needs user action (payment method failed, card expired, etc.).
      abstract UserChoiceBillingDetails userChoiceBillingAndroid() Fires when a user selects alternative billing in the User Choice Billing dialog (Android only) Only triggered when the user selects alternative billing instead of Google Play billing

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Method Detail

      • developerProvidedBillingAndroid

         abstract DeveloperProvidedBillingDetailsAndroid developerProvidedBillingAndroid()

        Fires when a user selects developer billing in an External Payments or Billing Choice flow (Android only). The payload can contain an external transaction token, link URI, original transaction ID, and selected products. Billing Choice payload fields are available in OpenIAP Spec 2.1.0 / openiap-google 2.3.0 (requires Play Billing 9.1.0+).

      • promotedProductIOS

         abstract String promotedProductIOS()

        Fires when the App Store surfaces a promoted product (iOS only)

      • purchaseUpdated

         abstract Purchase purchaseUpdated(PurchaseUpdatedListenerOptions options)

        Fires when a purchase completes successfully or a pending purchase resolves Options can opt iOS listeners into duplicate StoreKit transaction replays for diagnostics; default listeners receive one event per transaction ID during a single connection session.

      • subscriptionBillingIssue

         abstract Purchase subscriptionBillingIssue()

        Fires when a subscription enters a billing-issue state that needs user action (payment method failed, card expired, etc.). Cross-platform unification:

        • iOS 16.4+ / Mac Catalyst 16.4+ / visionOS 1.0+: delivered via StoreKit 2 Message.Reason.billingIssue.

        • Android (Play flavor, Billing 8.1+): emitted when isSuspended == true is first detected on a previously healthy subscription. Requires Google Play Billing Library 8.1.0 or newer.

        • Android (Horizon flavor): NOT emitted. The Horizon Billing Compatibility SDK implements the Play Billing 7.0 API surface which does not expose a suspended-subscription signal.

        • Android (Amazon flavor): NOT emitted. Amazon Appstore IAP does not expose an equivalent subscription billing-issue signal.

        Listeners should not assume the event will fire on every store. Direct users to the platform subscription management UI (deepLinkToSubscriptions) to resolve the issue.

      • userChoiceBillingAndroid

         abstract UserChoiceBillingDetails userChoiceBillingAndroid()

        Fires when a user selects alternative billing in the User Choice Billing dialog (Android only) Only triggered when the user selects alternative billing instead of Google Play billing