react-native-iap 15.4.0-rc.3 → 15.4.0

package/src/index.ts

@@ -18,11 +18,6 @@ import {ErrorCode} from './types';
 import type {
   AndroidSubscriptionOfferInput,
   DiscountOfferInputIOS,
-  ExternalPurchaseCustomLinkNoticeResultIOS,
-  ExternalPurchaseCustomLinkNoticeTypeIOS,
-  ExternalPurchaseCustomLinkTokenResultIOS,
-  ExternalPurchaseCustomLinkTokenTypeIOS,
-  ExternalPurchaseNoticeResultIOS,
   FetchProductsResult,
   MutationField,
   Product,
@@ -73,7 +68,17 @@ import {getVegaIapModule, isVegaOS} from './vega';
 // Note: BillingProgramAndroid, ExternalLinkLaunchModeAndroid, and ExternalLinkTypeAndroid
 // are exported from './types' (auto-generated from openiap-gql).
 // Import them here for use in this file's interfaces and functions.
-import type {BillingProgramAndroid} from './types';
+import type {
+  BillingChoiceInfoAndroid,
+  BillingProgramAndroid,
+  BillingProgramInformationDialogParamsAndroid,
+  BillingProgramReportingDetailsAndroid,
+  BillingResultAndroid,
+  DeveloperBillingTypeAndroid,
+  GetBillingChoiceInfoParamsAndroid,
+  InAppMessageParamsAndroid,
+  InAppMessageResultAndroid,
+} from './types';
 
 // Export all types
 export type {
@@ -621,12 +626,11 @@ export const userChoiceBillingListenerAndroid = (
 };
 
 /**
- * Add a listener for developer provided billing events (Android 8.3.0+ only).
- * Fires when a user selects developer billing in the External Payments flow.
+ * Add a listener for developer provided billing events (Android 8.3.0+).
+ * Fires for External Payments and Billing Choice developer billing flows.
  *
- * External Payments is part of Google Play Billing Library 8.3.0+ and allows
- * showing a side-by-side choice between Google Play Billing and developer's
- * external payment option directly in the purchase flow. (Japan only)
+ * The payload includes selected products and nullable token, link, and original
+ * transaction fields. Billing Choice fields require Billing Library 9.1.0+.
  *
  * @param listener - Function to call when user chooses developer billing
  * @returns EventSubscription with remove() method to unsubscribe
@@ -636,14 +640,10 @@ export const userChoiceBillingListenerAndroid = (
  * @example
  * ```typescript
  * const subscription = developerProvidedBillingListenerAndroid((details) => {
- *   console.log('User chose developer billing');
- *   console.log('External transaction token received; send it to your backend without logging it.');
- *
- *   // Process payment through your external payment system
- *   await processExternalPayment();
- *
- *   // Report transaction to Google Play (within 24 hours)
- *   await reportToGooglePlay(details.externalTransactionToken);
+ *   await processExternalPayment(details.products, details.linkUri);
+ *   if (details.externalTransactionToken) {
+ *     await reportToGooglePlay(details.externalTransactionToken);
+ *   }
  * });
  *
  * // Later, remove the listener
@@ -854,8 +854,7 @@ export const fetchProducts: QueryField<'fetchProducts'> = async (request) => {
 
     if (normalizedType === 'all') {
       const converted = (await fetchAndConvert('all')) as (
-        | Product
-        | ProductSubscription
+        Product | ProductSubscription
       )[];
 
       RnIapConsole.debug(
@@ -1621,6 +1620,10 @@ export const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (
  * ```ts
  * await initConnection();
  * await initConnection({ enableBillingProgramAndroid: 'external-offer' });
+ * await initConnection({
+ *   enableBillingProgramAndroid: 'billing-choice',
+ *   billingChoiceScreenTypeAndroid: 'developer-rendered',
+ * });
  * ```
  *
  * @remarks When using `useIAP()`, connection is auto-managed on mount/unmount —
@@ -1843,6 +1846,10 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
       if (androidRequest.isOfferPersonalized != null) {
         androidPayload.isOfferPersonalized = androidRequest.isOfferPersonalized;
       }
+      if (androidRequest.developerBillingOption) {
+        androidPayload.developerBillingOption =
+          androidRequest.developerBillingOption;
+      }
 
       // One-time purchase offerToken (Android 7.0+)
       if (!isSubs) {
@@ -1857,6 +1864,10 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
         if (subsRequest.purchaseToken) {
           androidPayload.purchaseToken = subsRequest.purchaseToken;
         }
+        if (subsRequest.originalExternalTransactionId) {
+          androidPayload.originalExternalTransactionId =
+            subsRequest.originalExternalTransactionId;
+        }
         if (subsRequest.replacementMode != null) {
           androidPayload.replacementMode = subsRequest.replacementMode;
         }
@@ -2394,41 +2405,42 @@ export const presentCodeRedemptionSheetIOS: MutationField<
  *
  * @see {@link https://openiap.dev/docs/apis/ios/request-purchase-on-promoted-product-ios}
  */
-export const requestPurchaseOnPromotedProductIOS =
-  async (): Promise<boolean> => {
-    if (Platform.OS !== 'ios') {
-      throw new Error(
-        'requestPurchaseOnPromotedProductIOS is only available on iOS',
-      );
-    }
-
-    try {
-      await IAP.instance.buyPromotedProductIOS();
-      const pending = await IAP.instance.getPendingTransactionsIOS();
-      const latest = pending.find((purchase) => purchase != null);
-      if (!latest) {
-        throw new Error('No promoted purchase available after request');
-      }
+export const requestPurchaseOnPromotedProductIOS: MutationField<
+  'requestPurchaseOnPromotedProductIOS'
+> = async () => {
+  if (Platform.OS !== 'ios') {
+    throw new Error(
+      'requestPurchaseOnPromotedProductIOS is only available on iOS',
+    );
+  }
 
-      const converted = convertNitroPurchaseToPurchase(latest);
-      if (converted.platform !== 'ios') {
-        throw new Error('Promoted purchase result not available for iOS');
-      }
+  try {
+    await IAP.instance.buyPromotedProductIOS();
+    const pending = await IAP.instance.getPendingTransactionsIOS();
+    const latest = pending.find((purchase) => purchase != null);
+    if (!latest) {
+      throw new Error('No promoted purchase available after request');
+    }
 
-      return true;
-    } catch (error) {
-      const parsedError = parseErrorAndLogIfNeeded(
-        '[requestPurchaseOnPromotedProductIOS] Failed:',
-        error,
-      );
-      throw createPurchaseError({
-        code: parsedError.code,
-        message: parsedError.message,
-        responseCode: parsedError.responseCode,
-        debugMessage: parsedError.debugMessage,
-      });
+    const converted = convertNitroPurchaseToPurchase(latest);
+    if (converted.platform !== 'ios') {
+      throw new Error('Promoted purchase result not available for iOS');
     }
-  };
+
+    return true;
+  } catch (error) {
+    const parsedError = parseErrorAndLogIfNeeded(
+      '[requestPurchaseOnPromotedProductIOS] Failed:',
+      error,
+    );
+    throw createPurchaseError({
+      code: parsedError.code,
+      message: parsedError.message,
+      responseCode: parsedError.responseCode,
+      debugMessage: parsedError.debugMessage,
+    });
+  }
+};
 
 /**
  * Clear unfinished transactions on iOS
@@ -2925,7 +2937,9 @@ export const isBillingProgramAvailableAndroid: MutationField<
     const result = await IAP.instance.isBillingProgramAvailableAndroid(program);
     return {
       billingProgram: result.billingProgram as unknown as BillingProgramAndroid,
+      choiceScreenType: result.choiceScreenType,
       isAvailable: result.isAvailable,
+      isExternalLinkAvailable: result.isExternalLinkAvailable,
     };
   } catch (error) {
     RnIapConsole.error('Failed to check billing program availability:', error);
@@ -2933,6 +2947,37 @@ export const isBillingProgramAvailableAndroid: MutationField<
   }
 };
 
+/**
+ * Fetch Play Billing assets and loyalty text for developer-rendered Billing Choice screens (Android only).
+ *
+ * @param params - Billing Choice info request parameters
+ * @returns Promise with Play-hosted image URL and optional loyalty information
+ * @platform Android
+ * @since Google Play Billing Library 9.1.0+
+ *
+ * @see {@link https://openiap.dev/docs/apis/android/get-billing-choice-info-android}
+ */
+export const getBillingChoiceInfoAndroid: QueryField<
+  'getBillingChoiceInfoAndroid'
+> = async (
+  params: GetBillingChoiceInfoParamsAndroid = {},
+): Promise<BillingChoiceInfoAndroid> => {
+  if (Platform.OS !== 'android') {
+    throw new Error('Billing Choice API is only supported on Android');
+  }
+  try {
+    return await IAP.instance.getBillingChoiceInfoAndroid({
+      billingProgram: params.billingProgram ?? 'billing-choice',
+      playBillingChoiceImageLayout:
+        params.playBillingChoiceImageLayout ?? 'rectangular-four-by-one',
+      userLocale: params.userLocale ?? null,
+    });
+  } catch (error) {
+    RnIapConsole.error('Failed to get Billing Choice info:', error);
+    throw error;
+  }
+};
+
 /**
  * Create billing program reporting details for external transactions (Android only).
  * Used to get the external transaction token needed for reporting to Google.
@@ -2954,15 +2999,34 @@ export const isBillingProgramAvailableAndroid: MutationField<
  *
  * @see {@link https://openiap.dev/docs/apis/android/create-billing-program-reporting-details-android}
  */
-export const createBillingProgramReportingDetailsAndroid: MutationField<
-  'createBillingProgramReportingDetailsAndroid'
-> = async (program) => {
+export const createBillingProgramReportingDetailsAndroid: MutationField<'createBillingProgramReportingDetailsAndroid'> &
+  ((
+    program: BillingProgramAndroid,
+    developerBillingType?: DeveloperBillingTypeAndroid | null,
+  ) => Promise<BillingProgramReportingDetailsAndroid>) = async (
+  programOrArgs:
+    | BillingProgramAndroid
+    | {
+        program: BillingProgramAndroid;
+        developerBillingType?: DeveloperBillingTypeAndroid | null;
+      },
+  developerBillingType?: DeveloperBillingTypeAndroid | null,
+): Promise<BillingProgramReportingDetailsAndroid> => {
   if (Platform.OS !== 'android') {
     throw new Error('Billing Programs API is only supported on Android');
   }
   try {
+    const program =
+      typeof programOrArgs === 'string' ? programOrArgs : programOrArgs.program;
+    const resolvedDeveloperBillingType =
+      typeof programOrArgs === 'string'
+        ? developerBillingType
+        : (programOrArgs.developerBillingType ?? developerBillingType);
     const result =
-      await IAP.instance.createBillingProgramReportingDetailsAndroid(program);
+      await IAP.instance.createBillingProgramReportingDetailsAndroid(
+        program,
+        resolvedDeveloperBillingType ?? null,
+      );
     return {
       billingProgram: result.billingProgram as unknown as BillingProgramAndroid,
       externalTransactionToken: result.externalTransactionToken,
@@ -2977,7 +3041,67 @@ export const createBillingProgramReportingDetailsAndroid: MutationField<
 };
 
 /**
- * Launch external link for external offers or app download (Android only).
+ * Show Google's mandatory information dialog before a developer-rendered,
+ * in-app Billing Choice screen (Android only).
+ *
+ * @param params - Dialog parameters with the external transaction token
+ * @returns Promise with BillingResult
+ * @platform Android
+ * @since Google Play Billing Library 9.1.0+
+ *
+ * @see {@link https://openiap.dev/docs/apis/android/show-billing-program-information-dialog-android}
+ */
+export const showBillingProgramInformationDialogAndroid: MutationField<
+  'showBillingProgramInformationDialogAndroid'
+> = async (
+  params: BillingProgramInformationDialogParamsAndroid,
+): Promise<BillingResultAndroid> => {
+  if (Platform.OS !== 'android') {
+    throw new Error('Billing Choice API is only supported on Android');
+  }
+  try {
+    return await IAP.instance.showBillingProgramInformationDialogAndroid({
+      billingProgram: params.billingProgram ?? 'billing-choice',
+      externalTransactionToken: params.externalTransactionToken,
+    });
+  } catch (error) {
+    RnIapConsole.error(
+      'Failed to show Billing Choice information dialog:',
+      error,
+    );
+    throw error;
+  }
+};
+
+/**
+ * Show Play Billing in-app messages, such as transactional subscription updates (Android only).
+ *
+ * @param params - Optional in-app message categories
+ * @returns Promise with in-app message result
+ * @platform Android
+ * @since Google Play Billing Library 4.1.0+
+ *
+ * @see {@link https://openiap.dev/docs/apis/android/show-in-app-messages-android}
+ */
+export const showInAppMessagesAndroid: MutationField<
+  'showInAppMessagesAndroid'
+> = async (
+  params?: InAppMessageParamsAndroid | null,
+): Promise<InAppMessageResultAndroid> => {
+  if (Platform.OS !== 'android') {
+    throw new Error('In-app messages are only supported on Android');
+  }
+  try {
+    return await IAP.instance.showInAppMessagesAndroid(params ?? null);
+  } catch (error) {
+    RnIapConsole.error('Failed to show in-app messages:', error);
+    throw error;
+  }
+};
+
+/**
+ * Launch an external link for Billing Programs (Android only). Developer-rendered
+ * Billing Choice external-link flows require 9.1.0+ and a pre-generated token.
  *
  * @param params - Parameters for launching the external link
  * @returns Promise<boolean> - true if user accepted, false otherwise
@@ -2987,7 +3111,8 @@ export const createBillingProgramReportingDetailsAndroid: MutationField<
  * @example
  * ```typescript
  * const success = await launchExternalLinkAndroid({
- *   billingProgram: 'external-offer',
+ *   billingProgram: 'billing-choice',
+ *   externalTransactionToken: reportingDetails.externalTransactionToken,
  *   launchMode: 'launch-in-external-browser-or-app',
  *   linkType: 'link-to-digital-content-offer',
  *   linkUri: 'https://your-website.com/purchase'
@@ -3008,6 +3133,7 @@ export const launchExternalLinkAndroid: MutationField<
   try {
     return await IAP.instance.launchExternalLinkAndroid({
       billingProgram: params.billingProgram,
+      externalTransactionToken: params.externalTransactionToken,
       launchMode: params.launchMode,
       linkType: params.linkType,
       linkUri: params.linkUri,
@@ -3078,21 +3204,22 @@ export const canPresentExternalPurchaseNoticeIOS: QueryField<
  *
  * @see {@link https://openiap.dev/docs/apis/ios/present-external-purchase-notice-sheet-ios}
  */
-export const presentExternalPurchaseNoticeSheetIOS =
-  async (): Promise<ExternalPurchaseNoticeResultIOS> => {
-    if (Platform.OS !== 'ios') {
-      throw new Error('External purchase is only supported on iOS');
-    }
-    try {
-      return await IAP.instance.presentExternalPurchaseNoticeSheetIOS();
-    } catch (error) {
-      RnIapConsole.error(
-        'Failed to present external purchase notice sheet:',
-        error,
-      );
-      throw error;
-    }
-  };
+export const presentExternalPurchaseNoticeSheetIOS: MutationField<
+  'presentExternalPurchaseNoticeSheetIOS'
+> = async () => {
+  if (Platform.OS !== 'ios') {
+    throw new Error('External purchase is only supported on iOS');
+  }
+  try {
+    return await IAP.instance.presentExternalPurchaseNoticeSheetIOS();
+  } catch (error) {
+    RnIapConsole.error(
+      'Failed to present external purchase notice sheet:',
+      error,
+    );
+    throw error;
+  }
+};
 
 /**
  * Present an external purchase link to redirect users to your website (iOS 16.0+).
@@ -3147,21 +3274,22 @@ export const presentExternalPurchaseLinkIOS: MutationField<
  *
  * @see {@link https://openiap.dev/docs/apis/ios/is-eligible-for-external-purchase-custom-link-ios}
  */
-export const isEligibleForExternalPurchaseCustomLinkIOS =
-  async (): Promise<boolean> => {
-    if (Platform.OS !== 'ios') {
-      return false;
-    }
-    try {
-      return await IAP.instance.isEligibleForExternalPurchaseCustomLinkIOS();
-    } catch (error) {
-      RnIapConsole.error(
-        'Failed to check external purchase custom link eligibility:',
-        error,
-      );
-      return false;
-    }
-  };
+export const isEligibleForExternalPurchaseCustomLinkIOS: QueryField<
+  'isEligibleForExternalPurchaseCustomLinkIOS'
+> = async () => {
+  if (Platform.OS !== 'ios') {
+    return false;
+  }
+  try {
+    return await IAP.instance.isEligibleForExternalPurchaseCustomLinkIOS();
+  } catch (error) {
+    RnIapConsole.error(
+      'Failed to check external purchase custom link eligibility:',
+      error,
+    );
+    return false;
+  }
+};
 
 /**
  * Get external purchase token for reporting to Apple (iOS 18.1+).
@@ -3184,9 +3312,9 @@ export const isEligibleForExternalPurchaseCustomLinkIOS =
  *
  * @see {@link https://openiap.dev/docs/apis/ios/get-external-purchase-custom-link-token-ios}
  */
-export const getExternalPurchaseCustomLinkTokenIOS = async (
-  tokenType: ExternalPurchaseCustomLinkTokenTypeIOS,
-): Promise<ExternalPurchaseCustomLinkTokenResultIOS> => {
+export const getExternalPurchaseCustomLinkTokenIOS: QueryField<
+  'getExternalPurchaseCustomLinkTokenIOS'
+> = async (tokenType) => {
   if (Platform.OS !== 'ios') {
     throw new Error(
       'External purchase custom link is only supported on iOS 18.1+',
@@ -3224,9 +3352,9 @@ export const getExternalPurchaseCustomLinkTokenIOS = async (
  *
  * @see {@link https://openiap.dev/docs/apis/ios/show-external-purchase-custom-link-notice-ios}
  */
-export const showExternalPurchaseCustomLinkNoticeIOS = async (
-  noticeType: ExternalPurchaseCustomLinkNoticeTypeIOS,
-): Promise<ExternalPurchaseCustomLinkNoticeResultIOS> => {
+export const showExternalPurchaseCustomLinkNoticeIOS: MutationField<
+  'showExternalPurchaseCustomLinkNoticeIOS'
+> = async (noticeType) => {
   if (Platform.OS !== 'ios') {
     throw new Error(
       'External purchase custom link is only supported on iOS 18.1+',

package/src/specs/RnIap.nitro.ts

@@ -35,6 +35,7 @@ import type {
   ExternalPurchaseCustomLinkTokenTypeIOS,
   ExternalPurchaseLinkResultIOS,
   ExternalPurchaseNoticeResultIOS,
+  DeveloperBillingOptionParamsAndroid,
   DeveloperProvidedBillingDetailsAndroid,
   MutationFinishTransactionArgs,
   ProductCommon,
@@ -53,6 +54,7 @@ import type {
   UserChoiceBillingDetails,
   PaymentModeIOS,
   SubscriptionProductReplacementParamsAndroid,
+  SubResponseCodeAndroid,
   WinBackOfferInputIOS,
 } from '../types';
 
@@ -96,13 +98,38 @@ export type PurchaseVerificationProvider = 'iapkit' | 'none';
 
 // Billing Programs API (Android)
 // GQL type exists but defined locally for Nitro codegen consistency
-// Android 8.2.0+, 8.3.0+ for external-payments, 7.0+ for user-choice-billing
+// Android 8.2.0+, 8.3.0+ for external-payments, 9.1.0+ for billing-choice,
+// 7.0+ for user-choice-billing
 export type BillingProgramAndroid =
   | 'unspecified'
   | 'external-content-link'
   | 'external-offer'
   | 'external-payments'
-  | 'user-choice-billing';
+  | 'user-choice-billing'
+  | 'billing-choice';
+
+export type BillingChoiceImageLayoutAndroid =
+  | 'rectangular-four-by-one'
+  | 'rectangular-three-by-one'
+  | 'rectangular-two-by-two';
+
+export type BillingChoiceScreenTypeAndroid =
+  | 'unspecified'
+  | 'developer-rendered'
+  | 'google-rendered';
+
+export type DeveloperBillingTypeAndroid =
+  | 'developer-billing-type-unspecified'
+  | 'in-app'
+  | 'external-link';
+
+export type InAppMessageCategoryAndroid =
+  | 'unknown-in-app-message-category-id'
+  | 'transactional';
+
+export type InAppMessageResponseCodeAndroid =
+  | 'no-action-needed'
+  | 'subscription-status-updated';
 
 // Developer Billing Launch Mode (Android 8.3.0+)
 // Defined locally for Nitro codegen
@@ -218,6 +245,10 @@ export interface NitroRequestPurchaseAndroid {
   /** @deprecated Use subscriptionProductReplacementParams instead for item-level replacement (8.1.0+) */
   replacementMode?: RequestSubscriptionAndroidProps['replacementMode'];
   purchaseToken?: RequestSubscriptionAndroidProps['purchaseToken'];
+  /** Original external transaction ID for developer-billed subscription replacement (9.1.0+). */
+  originalExternalTransactionId?: RequestSubscriptionAndroidProps['originalExternalTransactionId'];
+  /** Developer billing option for External Payments (8.3.0+) or Billing Choice (9.1.0+). */
+  developerBillingOption?: DeveloperBillingOptionParamsAndroid | null;
   /**
    * Product-level replacement parameters (8.1.0+)
    * Use this instead of replacementMode for item-level replacement
@@ -298,8 +329,10 @@ export interface NitroDeepLinkOptionsAndroid {
  * Parameters for launching an external link (Android 8.2.0+)
  */
 export interface NitroLaunchExternalLinkParamsAndroid {
-  /** The billing program (external-content-link or external-offer) */
+  /** The billing program (external-content-link, external-offer, or billing-choice) */
   billingProgram: BillingProgramAndroid;
+  /** Reporting token for a developer-rendered Billing Choice external-link flow (9.1.0+). */
+  externalTransactionToken?: string | null;
   /** The external link launch mode */
   launchMode: ExternalLinkLaunchModeAndroid;
   /** The type of the external link */
@@ -308,6 +341,21 @@ export interface NitroLaunchExternalLinkParamsAndroid {
   linkUri: string;
 }
 
+export interface NitroGetBillingChoiceInfoParamsAndroid {
+  billingProgram: BillingProgramAndroid;
+  playBillingChoiceImageLayout: BillingChoiceImageLayoutAndroid;
+  userLocale?: string | null;
+}
+
+export interface NitroBillingProgramInformationDialogParamsAndroid {
+  billingProgram: BillingProgramAndroid;
+  externalTransactionToken: string;
+}
+
+export interface NitroInAppMessageParamsAndroid {
+  categories?: InAppMessageCategoryAndroid[] | null;
+}
+
 // ╔══════════════════════════════════════════════════════════════════════════╗
 // ║                                  TYPES                                   ║
 // ╚══════════════════════════════════════════════════════════════════════════╝
@@ -344,6 +392,22 @@ export interface NitroPurchaseResult {
   purchaseToken?: string;
 }
 
+export interface NitroBillingResultAndroid {
+  responseCode: number;
+  debugMessage?: string | null;
+  subResponseCode?: SubResponseCodeAndroid | null;
+}
+
+export interface NitroBillingChoiceInfoAndroid {
+  playBillingChoiceImageUrl: string;
+  playBillingLoyaltyInfo?: string | null;
+}
+
+export interface NitroInAppMessageResultAndroid {
+  responseCode: InAppMessageResponseCodeAndroid;
+  purchaseToken?: string | null;
+}
+
 export interface NitroReceiptValidationResultIOS {
   isValid: boolean;
   receiptData: string;
@@ -428,8 +492,12 @@ export interface NitroVerifyPurchaseWithProviderResult {
 export interface NitroBillingProgramAvailabilityResultAndroid {
   /** The billing program that was checked */
   billingProgram: BillingProgramAndroid;
+  /** Billing Choice screen renderer. Populated only for available Billing Choice results. */
+  choiceScreenType?: BillingChoiceScreenTypeAndroid | null;
   /** Whether the billing program is available for the user */
   isAvailable: boolean;
+  /** Whether external-link payment is available for Billing Choice. */
+  isExternalLinkAvailable?: boolean | null;
 }
 
 /**
@@ -505,6 +573,7 @@ export interface NitroOneTimePurchaseOfferDetail {
   preorderDetailsAndroid?: NitroPreorderDetailsAndroid | null;
   priceAmountMicros: string;
   priceCurrencyCode: string;
+  purchaseOptionId?: string | null;
   rentalDetailsAndroid?: NitroRentalDetailsAndroid | null;
   validTimeWindow?: NitroValidTimeWindowAndroid | null;
 }
@@ -602,6 +671,7 @@ export interface NitroProduct {
   id: ProductCommon['id'];
   title: ProductCommon['title'];
   description: ProductCommon['description'];
+  debugDescription?: ProductCommon['debugDescription'];
   type: string;
   displayName?: ProductCommon['displayName'];
   displayPrice?: ProductCommon['displayPrice'];
@@ -612,6 +682,8 @@ export interface NitroProduct {
   typeIOS?: string | null;
   isFamilyShareableIOS?: boolean | null;
   jsonRepresentationIOS?: string | null;
+  pricingTermsIOS?: string | null;
+  subscriptionInfoIOS?: string | null;
   discountsIOS?: string | null;
   introductoryPriceIOS?: string | null;
   introductoryPriceAsAmountIOS?: number | null;
@@ -1086,12 +1158,11 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
   ): void;
 
   /**
-   * Add a listener for developer provided billing events (Android 8.3.0+ only).
-   * Fires when a user selects developer billing in the External Payments flow.
+   * Add a listener for developer provided billing events (Android 8.3.0+).
+   * Fires for External Payments and Billing Choice developer billing flows.
    *
-   * External Payments is part of Google Play Billing Library 8.3.0+ and allows
-   * showing a side-by-side choice between Google Play Billing and developer's
-   * external payment option directly in the purchase flow. (Japan only)
+   * Billing Choice expands the payload with nullable link/original transaction
+   * fields and selected products in Billing Library 9.1.0+.
    *
    * @param listener - Function to call when user chooses developer billing
    * @platform Android
@@ -1161,6 +1232,18 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
     program: BillingProgramAndroid,
   ): Promise<NitroBillingProgramAvailabilityResultAndroid>;
 
+  /**
+   * Fetch Play Billing assets and loyalty text for developer-rendered Billing Choice screens.
+   *
+   * @param params - Billing Choice info request parameters
+   * @returns Promise with the Play-hosted image URL and optional loyalty info
+   * @platform Android
+   * @since Billing Library 9.1.0+
+   */
+  getBillingChoiceInfoAndroid(
+    params: NitroGetBillingChoiceInfoParamsAndroid,
+  ): Promise<NitroBillingChoiceInfoAndroid>;
+
   /**
    * Create billing program reporting details for external transactions (Android only).
    * Used to get the external transaction token needed for reporting to Google.
@@ -1172,8 +1255,33 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
    */
   createBillingProgramReportingDetailsAndroid(
     program: BillingProgramAndroid,
+    developerBillingType?: DeveloperBillingTypeAndroid | null,
   ): Promise<NitroBillingProgramReportingDetailsAndroid>;
 
+  /**
+   * Show the Play-provided Billing Choice information dialog.
+   *
+   * @param params - Billing Choice dialog parameters
+   * @returns Promise with BillingResult
+   * @platform Android
+   * @since Billing Library 9.1.0+
+   */
+  showBillingProgramInformationDialogAndroid(
+    params: NitroBillingProgramInformationDialogParamsAndroid,
+  ): Promise<NitroBillingResultAndroid>;
+
+  /**
+   * Show Play Billing in-app messages, such as transactional subscription updates.
+   *
+   * @param params - Optional in-app message categories
+   * @returns Promise with in-app message result
+   * @platform Android
+   * @since Billing Library 4.1.0+
+   */
+  showInAppMessagesAndroid(
+    params?: NitroInAppMessageParamsAndroid | null,
+  ): Promise<NitroInAppMessageResultAndroid>;
+
   /**
    * Launch external link for external offers or app download (Android only).
    *