react-native-iap 14.6.3 → 14.6.4

package/nitrogen/generated/shared/c++/DeveloperProvidedBillingDetailsAndroid.hpp

@@ -0,0 +1,75 @@
+///
+/// DeveloperProvidedBillingDetailsAndroid.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+
+namespace margelo::nitro::iap {
+
+  /**
+   * A struct which can be represented as a JavaScript object (DeveloperProvidedBillingDetailsAndroid).
+   */
+  struct DeveloperProvidedBillingDetailsAndroid {
+  public:
+    std::string externalTransactionToken     SWIFT_PRIVATE;
+
+  public:
+    DeveloperProvidedBillingDetailsAndroid() = default;
+    explicit DeveloperProvidedBillingDetailsAndroid(std::string externalTransactionToken): externalTransactionToken(externalTransactionToken) {}
+  };
+
+} // namespace margelo::nitro::iap
+
+namespace margelo::nitro {
+
+  // C++ DeveloperProvidedBillingDetailsAndroid <> JS DeveloperProvidedBillingDetailsAndroid (object)
+  template <>
+  struct JSIConverter<margelo::nitro::iap::DeveloperProvidedBillingDetailsAndroid> final {
+    static inline margelo::nitro::iap::DeveloperProvidedBillingDetailsAndroid fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::iap::DeveloperProvidedBillingDetailsAndroid(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "externalTransactionToken"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::DeveloperProvidedBillingDetailsAndroid& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "externalTransactionToken", JSIConverter<std::string>::toJSI(runtime, arg.externalTransactionToken));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "externalTransactionToken"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/HybridRnIapSpec.cpp

@@ -58,6 +58,8 @@ namespace margelo::nitro::iap {
       prototype.registerHybridMethod("createAlternativeBillingTokenAndroid", &HybridRnIapSpec::createAlternativeBillingTokenAndroid);
       prototype.registerHybridMethod("addUserChoiceBillingListenerAndroid", &HybridRnIapSpec::addUserChoiceBillingListenerAndroid);
       prototype.registerHybridMethod("removeUserChoiceBillingListenerAndroid", &HybridRnIapSpec::removeUserChoiceBillingListenerAndroid);
+      prototype.registerHybridMethod("addDeveloperProvidedBillingListenerAndroid", &HybridRnIapSpec::addDeveloperProvidedBillingListenerAndroid);
+      prototype.registerHybridMethod("removeDeveloperProvidedBillingListenerAndroid", &HybridRnIapSpec::removeDeveloperProvidedBillingListenerAndroid);
       prototype.registerHybridMethod("enableBillingProgramAndroid", &HybridRnIapSpec::enableBillingProgramAndroid);
       prototype.registerHybridMethod("isBillingProgramAvailableAndroid", &HybridRnIapSpec::isBillingProgramAvailableAndroid);
       prototype.registerHybridMethod("createBillingProgramReportingDetailsAndroid", &HybridRnIapSpec::createBillingProgramReportingDetailsAndroid);

package/nitrogen/generated/shared/c++/HybridRnIapSpec.hpp

@@ -49,6 +49,8 @@ namespace margelo::nitro::iap { struct NitroVerifyPurchaseWithProviderProps; }
 namespace margelo::nitro::iap { struct NitroDeepLinkOptionsAndroid; }
 // Forward declaration of `UserChoiceBillingDetails` to properly resolve imports.
 namespace margelo::nitro::iap { struct UserChoiceBillingDetails; }
+// Forward declaration of `DeveloperProvidedBillingDetailsAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { struct DeveloperProvidedBillingDetailsAndroid; }
 // Forward declaration of `BillingProgramAndroid` to properly resolve imports.
 namespace margelo::nitro::iap { enum class BillingProgramAndroid; }
 // Forward declaration of `NitroBillingProgramAvailabilityResultAndroid` to properly resolve imports.
@@ -86,6 +88,7 @@ namespace margelo::nitro::iap { struct ExternalPurchaseLinkResultIOS; }
 #include "NitroVerifyPurchaseWithProviderProps.hpp"
 #include "NitroDeepLinkOptionsAndroid.hpp"
 #include "UserChoiceBillingDetails.hpp"
+#include "DeveloperProvidedBillingDetailsAndroid.hpp"
 #include "BillingProgramAndroid.hpp"
 #include "NitroBillingProgramAvailabilityResultAndroid.hpp"
 #include "NitroBillingProgramReportingDetailsAndroid.hpp"
@@ -168,6 +171,8 @@ namespace margelo::nitro::iap {
       virtual std::shared_ptr<Promise<std::optional<std::string>>> createAlternativeBillingTokenAndroid(const std::optional<std::string>& sku) = 0;
       virtual void addUserChoiceBillingListenerAndroid(const std::function<void(const UserChoiceBillingDetails& /* details */)>& listener) = 0;
       virtual void removeUserChoiceBillingListenerAndroid(const std::function<void(const UserChoiceBillingDetails& /* details */)>& listener) = 0;
+      virtual void addDeveloperProvidedBillingListenerAndroid(const std::function<void(const DeveloperProvidedBillingDetailsAndroid& /* details */)>& listener) = 0;
+      virtual void removeDeveloperProvidedBillingListenerAndroid(const std::function<void(const DeveloperProvidedBillingDetailsAndroid& /* details */)>& listener) = 0;
       virtual void enableBillingProgramAndroid(BillingProgramAndroid program) = 0;
       virtual std::shared_ptr<Promise<NitroBillingProgramAvailabilityResultAndroid>> isBillingProgramAvailableAndroid(BillingProgramAndroid program) = 0;
       virtual std::shared_ptr<Promise<NitroBillingProgramReportingDetailsAndroid>> createBillingProgramReportingDetailsAndroid(BillingProgramAndroid program) = 0;

package/nitrogen/generated/shared/c++/InitConnectionConfig.hpp

@@ -25,9 +25,12 @@
 
 // Forward declaration of `AlternativeBillingModeAndroid` to properly resolve imports.
 namespace margelo::nitro::iap { enum class AlternativeBillingModeAndroid; }
+// Forward declaration of `BillingProgramAndroid` to properly resolve imports.
+namespace margelo::nitro::iap { enum class BillingProgramAndroid; }
 
 #include "AlternativeBillingModeAndroid.hpp"
 #include <optional>
+#include "BillingProgramAndroid.hpp"
 
 namespace margelo::nitro::iap {
 
@@ -37,10 +40,11 @@ namespace margelo::nitro::iap {
   struct InitConnectionConfig {
   public:
     std::optional<AlternativeBillingModeAndroid> alternativeBillingModeAndroid     SWIFT_PRIVATE;
+    std::optional<BillingProgramAndroid> enableBillingProgramAndroid     SWIFT_PRIVATE;
 
   public:
     InitConnectionConfig() = default;
-    explicit InitConnectionConfig(std::optional<AlternativeBillingModeAndroid> alternativeBillingModeAndroid): alternativeBillingModeAndroid(alternativeBillingModeAndroid) {}
+    explicit InitConnectionConfig(std::optional<AlternativeBillingModeAndroid> alternativeBillingModeAndroid, std::optional<BillingProgramAndroid> enableBillingProgramAndroid): alternativeBillingModeAndroid(alternativeBillingModeAndroid), enableBillingProgramAndroid(enableBillingProgramAndroid) {}
   };
 
 } // namespace margelo::nitro::iap
@@ -53,12 +57,14 @@ namespace margelo::nitro {
     static inline margelo::nitro::iap::InitConnectionConfig fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::iap::InitConnectionConfig(
-        JSIConverter<std::optional<margelo::nitro::iap::AlternativeBillingModeAndroid>>::fromJSI(runtime, obj.getProperty(runtime, "alternativeBillingModeAndroid"))
+        JSIConverter<std::optional<margelo::nitro::iap::AlternativeBillingModeAndroid>>::fromJSI(runtime, obj.getProperty(runtime, "alternativeBillingModeAndroid")),
+        JSIConverter<std::optional<margelo::nitro::iap::BillingProgramAndroid>>::fromJSI(runtime, obj.getProperty(runtime, "enableBillingProgramAndroid"))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::iap::InitConnectionConfig& arg) {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, "alternativeBillingModeAndroid", JSIConverter<std::optional<margelo::nitro::iap::AlternativeBillingModeAndroid>>::toJSI(runtime, arg.alternativeBillingModeAndroid));
+      obj.setProperty(runtime, "enableBillingProgramAndroid", JSIConverter<std::optional<margelo::nitro::iap::BillingProgramAndroid>>::toJSI(runtime, arg.enableBillingProgramAndroid));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -70,6 +76,7 @@ namespace margelo::nitro {
         return false;
       }
       if (!JSIConverter<std::optional<margelo::nitro::iap::AlternativeBillingModeAndroid>>::canConvert(runtime, obj.getProperty(runtime, "alternativeBillingModeAndroid"))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::iap::BillingProgramAndroid>>::canConvert(runtime, obj.getProperty(runtime, "enableBillingProgramAndroid"))) return false;
       return true;
     }
   };

package/openiap-versions.json

@@ -1,6 +1,6 @@
 {
-  "apple": "1.3.7",
-  "google": "1.3.16",
-  "gql": "1.3.8",
+  "apple": "1.3.8",
+  "google": "1.3.19",
+  "gql": "1.3.10",
   "docs": "1.3.7"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "14.6.3",
+  "version": "14.6.4",
   "description": "React Native In-App Purchases module for iOS and Android using Nitro",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/index.ts

@@ -55,6 +55,19 @@ import {RnIapConsole} from './utils/debug';
 import {getSuccessFromPurchaseVariant} from './utils/purchase';
 import {parseAppTransactionPayload} from './utils';
 
+// ------------------------------
+// Billing Programs API (Android 8.2.0+)
+// ------------------------------
+
+// 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,
+  ExternalLinkLaunchModeAndroid,
+  ExternalLinkTypeAndroid,
+} from './types';
+
 // Export all types
 export type {
   RnIap,
@@ -371,6 +384,98 @@ 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.
+ *
+ * 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)
+ *
+ * @param listener - Function to call when user chooses developer billing
+ * @returns EventSubscription with remove() method to unsubscribe
+ * @platform Android
+ * @since Google Play Billing Library 8.3.0+
+ *
+ * @example
+ * ```typescript
+ * const subscription = developerProvidedBillingListenerAndroid((details) => {
+ *   console.log('User chose developer billing');
+ *   console.log('Token:', details.externalTransactionToken);
+ *
+ *   // Process payment through your external payment system
+ *   await processExternalPayment();
+ *
+ *   // Report transaction to Google Play (within 24 hours)
+ *   await reportToGooglePlay(details.externalTransactionToken);
+ * });
+ *
+ * // Later, remove the listener
+ * subscription.remove();
+ * ```
+ */
+type NitroDeveloperProvidedBillingListener = Parameters<
+  RnIap['addDeveloperProvidedBillingListenerAndroid']
+>[0];
+const developerProvidedBillingListenerMap = new WeakMap<
+  (details: any) => void,
+  NitroDeveloperProvidedBillingListener
+>();
+
+export interface DeveloperProvidedBillingDetailsAndroid {
+  /**
+   * External transaction token used to report transactions made through developer billing.
+   * This token must be used when reporting the external transaction to Google Play.
+   * Must be reported within 24 hours of the transaction.
+   */
+  externalTransactionToken: string;
+}
+
+export const developerProvidedBillingListenerAndroid = (
+  listener: (details: DeveloperProvidedBillingDetailsAndroid) => void,
+): EventSubscription => {
+  if (Platform.OS !== 'android') {
+    RnIapConsole.warn(
+      'developerProvidedBillingListenerAndroid: This listener is only available on Android',
+    );
+    return {remove: () => {}};
+  }
+
+  const wrappedListener: NitroDeveloperProvidedBillingListener = (details) => {
+    listener(details);
+  };
+
+  developerProvidedBillingListenerMap.set(listener, wrappedListener);
+  let attached = false;
+  try {
+    IAP.instance.addDeveloperProvidedBillingListenerAndroid(wrappedListener);
+    attached = true;
+  } catch (e) {
+    const msg = toErrorMessage(e);
+    if (msg.includes('Nitro runtime not installed')) {
+      RnIapConsole.warn(
+        '[developerProvidedBillingListenerAndroid] Nitro not ready yet; listener inert until initConnection()',
+      );
+    } else {
+      throw e;
+    }
+  }
+
+  return {
+    remove: () => {
+      const wrapped = developerProvidedBillingListenerMap.get(listener);
+      if (wrapped) {
+        if (attached) {
+          try {
+            IAP.instance.removeDeveloperProvidedBillingListenerAndroid(wrapped);
+          } catch {}
+        }
+        developerProvidedBillingListenerMap.delete(listener);
+      }
+    },
+  };
+};
+
 // ------------------------------
 // Query API
 // ------------------------------
@@ -2246,40 +2351,6 @@ export const createAlternativeBillingTokenAndroid: MutationField<
   }
 };
 
-// ------------------------------
-// Billing Programs API (Android 8.2.0+)
-// ------------------------------
-
-/**
- * Billing program type for external content links and external offers.
- * @platform Android
- * @since Google Play Billing Library 8.2.0+
- */
-export type BillingProgramAndroid =
-  | 'unspecified'
-  | 'external-content-link'
-  | 'external-offer';
-
-/**
- * Launch mode for external link flow.
- * @platform Android
- * @since Google Play Billing Library 8.2.0+
- */
-export type ExternalLinkLaunchModeAndroid =
-  | 'unspecified'
-  | 'launch-in-external-browser-or-app'
-  | 'caller-will-launch-link';
-
-/**
- * Link type for external link flow.
- * @platform Android
- * @since Google Play Billing Library 8.2.0+
- */
-export type ExternalLinkTypeAndroid =
-  | 'unspecified'
-  | 'link-to-digital-content-offer'
-  | 'link-to-app-download';
-
 /**
  * Parameters for launching an external link (Android 8.2.0+).
  */

package/src/specs/RnIap.nitro.ts

@@ -45,11 +45,18 @@ export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
 // Note: Nitro requires at least 2 values for union types
 export type PurchaseVerificationProvider = 'iapkit' | 'none';
 
-// Billing Programs API types (Android 8.2.0+)
+// Billing Programs API types (Android 8.2.0+, 8.3.0+ for external-payments)
 export type BillingProgramAndroid =
   | 'unspecified'
   | 'external-content-link'
-  | 'external-offer';
+  | 'external-offer'
+  | 'external-payments';
+
+// Developer Billing Launch Mode (Android 8.3.0+)
+export type DeveloperBillingLaunchModeAndroid =
+  | 'unspecified'
+  | 'launch-in-external-browser-or-app'
+  | 'caller-will-launch-link';
 
 export type ExternalLinkLaunchModeAndroid =
   | 'unspecified'
@@ -321,6 +328,19 @@ export interface NitroBillingProgramReportingDetailsAndroid {
   externalTransactionToken: string;
 }
 
+/**
+ * Details provided when user selects developer billing option (Android 8.3.0+)
+ * Received via DeveloperProvidedBillingListener callback in External Payments flow
+ */
+export interface DeveloperProvidedBillingDetailsAndroid {
+  /**
+   * External transaction token used to report transactions made through developer billing.
+   * This token must be used when reporting the external transaction to Google Play.
+   * Must be reported within 24 hours of the transaction.
+   */
+  externalTransactionToken: string;
+}
+
 /**
  * Discount amount details for one-time purchase offers (Android)
  */
@@ -941,6 +961,33 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
     listener: (details: UserChoiceBillingDetails) => void,
   ): 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.
+   *
+   * 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)
+   *
+   * @param listener - Function to call when user chooses developer billing
+   * @platform Android
+   * @since Billing Library 8.3.0+
+   */
+  addDeveloperProvidedBillingListenerAndroid(
+    listener: (details: DeveloperProvidedBillingDetailsAndroid) => void,
+  ): void;
+
+  /**
+   * Remove a developer provided billing listener (Android only).
+   *
+   * @param listener - Function to remove from listeners
+   * @platform Android
+   * @since Billing Library 8.3.0+
+   */
+  removeDeveloperProvidedBillingListenerAndroid(
+    listener: (details: DeveloperProvidedBillingDetailsAndroid) => void,
+  ): void;
+
   // ╔════════════════════════════════════════════════════════════════════════╗
   // ║                 BILLING PROGRAMS API (Android 8.2.0+)                  ║
   // ╚════════════════════════════════════════════════════════════════════════╝

package/src/types.ts

@@ -66,10 +66,10 @@ export interface AppTransaction {
 }
 
 /**
- * Billing program types for external content links and external offers (Android)
- * Available in Google Play Billing Library 8.2.0+
+ * Billing program types for external content links, external offers, and external payments (Android)
+ * Available in Google Play Billing Library 8.2.0+, EXTERNAL_PAYMENTS added in 8.3.0
  */
-export type BillingProgramAndroid = 'unspecified' | 'external-content-link' | 'external-offer';
+export type BillingProgramAndroid = 'unspecified' | 'external-content-link' | 'external-offer' | 'external-payments';
 
 /**
  * Result of checking billing program availability (Android)
@@ -97,6 +97,16 @@ export interface BillingProgramReportingDetailsAndroid {
   externalTransactionToken: string;
 }
 
+/**
+ * Parameters for creating billing program reporting details (Android)
+ * Used with createBillingProgramReportingDetailsAsync
+ * Available in Google Play Billing Library 8.3.0+
+ */
+export interface BillingProgramReportingDetailsParamsAndroid {
+  /** The billing program to create reporting details for */
+  billingProgram: BillingProgramAndroid;
+}
+
 export interface DeepLinkOptions {
   /** Android package name to target (required on Android) */
   packageNameAndroid?: (string | null);
@@ -104,6 +114,41 @@ export interface DeepLinkOptions {
   skuAndroid?: (string | null);
 }
 
+/**
+ * Launch mode for developer billing option (Android)
+ * Determines how the external payment URL is launched
+ * Available in Google Play Billing Library 8.3.0+
+ */
+export type DeveloperBillingLaunchModeAndroid = 'unspecified' | 'launch-in-external-browser-or-app' | 'caller-will-launch-link';
+
+/**
+ * Parameters for developer billing option in purchase flow (Android)
+ * Used with BillingFlowParams to enable external payments flow
+ * Available in Google Play Billing Library 8.3.0+
+ */
+export interface DeveloperBillingOptionParamsAndroid {
+  /** The billing program (should be EXTERNAL_PAYMENTS for external payments flow) */
+  billingProgram: BillingProgramAndroid;
+  /** The launch mode for the external payment link */
+  launchMode: DeveloperBillingLaunchModeAndroid;
+  /** The URI where the external payment will be processed */
+  linkUri: string;
+}
+
+/**
+ * Details provided when user selects developer billing option (Android)
+ * Received via DeveloperProvidedBillingListener callback
+ * Available in Google Play Billing Library 8.3.0+
+ */
+export interface DeveloperProvidedBillingDetailsAndroid {
+  /**
+   * External transaction token used to report transactions made through developer billing.
+   * This token must be used when reporting the external transaction to Google Play.
+   * Must be reported within 24 hours of the transaction.
+   */
+  externalTransactionToken: string;
+}
+
 /**
  * Discount amount details for one-time purchase offers (Android)
  * Available in Google Play Billing Library 7.0+
@@ -270,7 +315,7 @@ export interface ExternalPurchaseNoticeResultIOS {
 
 export type FetchProductsResult = ProductOrSubscription[] | Product[] | ProductSubscription[] | null;
 
-export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product-ios' | 'user-choice-billing-android';
+export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product-ios' | 'user-choice-billing-android' | 'developer-provided-billing-android';
 
 export type IapPlatform = 'ios' | 'android';
 
@@ -286,6 +331,12 @@ export interface InitConnectionConfig {
    * If not specified, defaults to NONE (standard Google Play billing)
    */
   alternativeBillingModeAndroid?: (AlternativeBillingModeAndroid | null);
+  /**
+   * Enable a specific billing program for Android (8.2.0+)
+   * When set, enables the specified billing program for external transactions.
+   * Use 'external-payments' for Developer Provided Billing (Japan only, 8.3.0+).
+   */
+  enableBillingProgramAndroid?: (BillingProgramAndroid | null);
 }
 
 /**
@@ -918,6 +969,12 @@ export interface RentalDetailsAndroid {
 }
 
 export interface RequestPurchaseAndroidProps {
+  /**
+   * Developer billing option parameters for external payments flow (8.3.0+).
+   * When provided, the purchase flow will show a side-by-side choice between
+   * Google Play Billing and the developer's external payment option.
+   */
+  developerBillingOption?: (DeveloperBillingOptionParamsAndroid | null);
   /** Personalized offer flag */
   isOfferPersonalized?: (boolean | null);
   /** Obfuscated account ID */
@@ -986,6 +1043,12 @@ export interface RequestPurchasePropsByPlatforms {
 export type RequestPurchaseResult = Purchase | Purchase[] | null;
 
 export interface RequestSubscriptionAndroidProps {
+  /**
+   * Developer billing option parameters for external payments flow (8.3.0+).
+   * When provided, the purchase flow will show a side-by-side choice between
+   * Google Play Billing and the developer's external payment option.
+   */
+  developerBillingOption?: (DeveloperBillingOptionParamsAndroid | null);
   /** Personalized offer flag */
   isOfferPersonalized?: (boolean | null);
   /** Obfuscated account ID */
@@ -1078,6 +1141,14 @@ export interface RequestVerifyPurchaseWithIapkitResult {
 }
 
 export interface Subscription {
+  /**
+   * Fires when a user selects developer billing in the External Payments flow (Android only)
+   * Triggered when the user chooses to pay via the developer's external payment option
+   * instead of Google Play Billing in the side-by-side choice dialog.
+   * Contains the externalTransactionToken needed to report the transaction.
+   * Available in Google Play Billing Library 8.3.0+
+   */
+  developerProvidedBillingAndroid: DeveloperProvidedBillingDetailsAndroid;
   /** Fires when the App Store surfaces a promoted product (iOS only) */
   promotedProductIOS: string;
   /** Fires when a purchase fails or is cancelled */
@@ -1375,6 +1446,7 @@ export type MutationFieldMap = {
 
 // -- Subscription helper types (auto-generated)
 export type SubscriptionArgsMap = {
+  developerProvidedBillingAndroid: never;
   promotedProductIOS: never;
   purchaseError: never;
   purchaseUpdated: never;