expo-iap 3.1.7 → 3.1.9

package/ios/ExpoIapHelper.swift

@@ -86,6 +86,10 @@ enum ExpoIapHelper {
             case .all:
                 break
             }
+            // Include useAlternativeBilling if present
+            if let useAlternativeBilling = payload["useAlternativeBilling"] {
+                normalized["useAlternativeBilling"] = useAlternativeBilling
+            }
             return try OpenIapSerialization.decode(
                 object: normalized, as: RequestPurchaseProps.self)
         }

package/ios/ExpoIapModule.swift

@@ -13,7 +13,7 @@ public final class ExpoIapModule: Module {
     nonisolated public func definition() -> ModuleDefinition {
         Name("ExpoIap")
 
-        Constants {
+        Property("errorCodes") {
             OpenIapSerialization.errorCodes()
         }
 
@@ -35,7 +35,9 @@ public final class ExpoIapModule: Module {
             }
         }
 
-        AsyncFunction("initConnection") { () async throws -> Bool in
+        AsyncFunction("initConnection") { (config: [String: Any]?) async throws -> Bool in
+            // Note: iOS doesn't support alternative billing config parameter
+            // Config is ignored on iOS platform
             let isConnected = try await OpenIapModule.shared.initConnection()
             await MainActor.run { self.isInitialized = isConnected }
             return isConnected
@@ -59,8 +61,10 @@ public final class ExpoIapModule: Module {
 
         AsyncFunction("requestPurchase") { (payload: [String: Any]) async throws -> Any? in
             ExpoIapLog.payload("requestPurchase", payload: payload)
+            print("🔍 [ExpoIap] Raw payload useAlternativeBilling: \(payload["useAlternativeBilling"] ?? "nil")")
             try await ExpoIapHelper.ensureConnection(isInitialized: self.isInitialized)
             let props = try ExpoIapHelper.decodeRequestPurchaseProps(from: payload)
+            print("🔍 [ExpoIap] Decoded props useAlternativeBilling: \(props.useAlternativeBilling ?? false)")
 
             do {
                 guard let result = try await OpenIapModule.shared.requestPurchase(props) else {
@@ -334,5 +338,33 @@ public final class ExpoIapModule: Module {
                 throw PurchaseError.make(code: .skuNotFound, productId: sku)
             }
         }
+
+        // MARK: - External Purchase (iOS 16.0+)
+
+        AsyncFunction("canPresentExternalPurchaseNoticeIOS") { () async throws -> Bool in
+            ExpoIapLog.payload("canPresentExternalPurchaseNoticeIOS", payload: nil)
+            try await ExpoIapHelper.ensureConnection(isInitialized: self.isInitialized)
+            let canPresent = try await OpenIapModule.shared.canPresentExternalPurchaseNoticeIOS()
+            ExpoIapLog.result("canPresentExternalPurchaseNoticeIOS", value: canPresent)
+            return canPresent
+        }
+
+        AsyncFunction("presentExternalPurchaseNoticeSheetIOS") { () async throws -> [String: Any] in
+            ExpoIapLog.payload("presentExternalPurchaseNoticeSheetIOS", payload: nil)
+            try await ExpoIapHelper.ensureConnection(isInitialized: self.isInitialized)
+            let result = try await OpenIapModule.shared.presentExternalPurchaseNoticeSheetIOS()
+            let sanitized = ExpoIapHelper.sanitizeDictionary(OpenIapSerialization.encode(result))
+            ExpoIapLog.result("presentExternalPurchaseNoticeSheetIOS", value: sanitized)
+            return sanitized
+        }
+
+        AsyncFunction("presentExternalPurchaseLinkIOS") { (url: String) async throws -> [String: Any] in
+            ExpoIapLog.payload("presentExternalPurchaseLinkIOS", payload: ["url": url])
+            try await ExpoIapHelper.ensureConnection(isInitialized: self.isInitialized)
+            let result = try await OpenIapModule.shared.presentExternalPurchaseLinkIOS(url)
+            let sanitized = ExpoIapHelper.sanitizeDictionary(OpenIapSerialization.encode(result))
+            ExpoIapLog.result("presentExternalPurchaseLinkIOS", value: sanitized)
+            return sanitized
+        }
     }
 }

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "apple": "1.2.4",
-  "google": "1.2.10",
-  "gql": "1.0.9"
+  "apple": "1.2.10",
+  "google": "1.2.12",
+  "gql": "1.0.12"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-iap",
-  "version": "3.1.7",
+  "version": "3.1.9",
   "description": "In App Purchase module in Expo",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/plugin/build/withIAP.d.ts

@@ -1,4 +1,22 @@
 import { ConfigPlugin } from 'expo/config-plugins';
+export interface IOSAlternativeBillingConfig {
+    /** Country codes where external purchases are supported (ISO 3166-1 alpha-2) */
+    countries?: string[];
+    /** External purchase URLs per country (iOS 15.4+) */
+    links?: Record<string, string>;
+    /** Multiple external purchase URLs per country (iOS 17.5+, up to 5 per country) */
+    multiLinks?: Record<string, string[]>;
+    /** Custom link regions (iOS 18.1+) */
+    customLinkRegions?: string[];
+    /** Streaming link regions for music apps (iOS 18.2+) */
+    streamingLinkRegions?: string[];
+    /** Enable external purchase link entitlement */
+    enableExternalPurchaseLink?: boolean;
+    /** Enable external purchase link streaming entitlement (music apps only) */
+    enableExternalPurchaseLinkStreaming?: boolean;
+}
+/** Add external purchase entitlements and Info.plist configuration */
+declare const withIosAlternativeBilling: ConfigPlugin<IOSAlternativeBillingConfig | undefined>;
 export interface ExpoIapPluginOptions {
     /** Local development path for OpenIAP library */
     localPath?: string | {
@@ -7,6 +25,14 @@ export interface ExpoIapPluginOptions {
     };
     /** Enable local development mode */
     enableLocalDev?: boolean;
+    /**
+     * iOS Alternative Billing configuration.
+     * Configure external purchase countries, links, and entitlements.
+     * Requires approval from Apple.
+     * @platform ios
+     */
+    iosAlternativeBilling?: IOSAlternativeBillingConfig;
 }
+export { withIosAlternativeBilling };
 declare const _default: ConfigPlugin<void | ExpoIapPluginOptions>;
 export default _default;

package/plugin/build/withIAP.js

@@ -36,6 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.withIosAlternativeBilling = void 0;
 const config_plugins_1 = require("expo/config-plugins");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -117,8 +118,68 @@ const withIapAndroid = (config, props) => {
     });
     return config;
 };
+/** Add external purchase entitlements and Info.plist configuration */
+const withIosAlternativeBilling = (config, options) => {
+    if (!options || !options.countries || options.countries.length === 0) {
+        return config;
+    }
+    // Add entitlements
+    config = (0, config_plugins_1.withEntitlementsPlist)(config, (config) => {
+        // Always add basic external purchase entitlement when countries are specified
+        config.modResults['com.apple.developer.storekit.external-purchase'] = true;
+        logOnce('✅ Added com.apple.developer.storekit.external-purchase to entitlements');
+        // Add external purchase link entitlement if enabled
+        if (options.enableExternalPurchaseLink) {
+            config.modResults['com.apple.developer.storekit.external-purchase-link'] =
+                true;
+            logOnce('✅ Added com.apple.developer.storekit.external-purchase-link to entitlements');
+        }
+        // Add streaming entitlement if enabled
+        if (options.enableExternalPurchaseLinkStreaming) {
+            config.modResults['com.apple.developer.storekit.external-purchase-link-streaming'] = true;
+            logOnce('✅ Added com.apple.developer.storekit.external-purchase-link-streaming to entitlements');
+        }
+        return config;
+    });
+    // Add Info.plist configuration
+    config = (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        const plist = config.modResults;
+        // 1. SKExternalPurchase (Required)
+        plist.SKExternalPurchase = options.countries;
+        logOnce(`✅ Added SKExternalPurchase with countries: ${options.countries?.join(', ')}`);
+        // 2. SKExternalPurchaseLink (Optional - iOS 15.4+)
+        if (options.links && Object.keys(options.links).length > 0) {
+            plist.SKExternalPurchaseLink = options.links;
+            logOnce(`✅ Added SKExternalPurchaseLink for ${Object.keys(options.links).length} countries`);
+        }
+        // 3. SKExternalPurchaseMultiLink (iOS 17.5+)
+        if (options.multiLinks && Object.keys(options.multiLinks).length > 0) {
+            plist.SKExternalPurchaseMultiLink = options.multiLinks;
+            logOnce(`✅ Added SKExternalPurchaseMultiLink for ${Object.keys(options.multiLinks).length} countries`);
+        }
+        // 4. SKExternalPurchaseCustomLinkRegions (iOS 18.1+)
+        if (options.customLinkRegions && options.customLinkRegions.length > 0) {
+            plist.SKExternalPurchaseCustomLinkRegions = options.customLinkRegions;
+            logOnce(`✅ Added SKExternalPurchaseCustomLinkRegions: ${options.customLinkRegions.join(', ')}`);
+        }
+        // 5. SKExternalPurchaseLinkStreamingRegions (iOS 18.2+)
+        if (options.streamingLinkRegions &&
+            options.streamingLinkRegions.length > 0) {
+            plist.SKExternalPurchaseLinkStreamingRegions =
+                options.streamingLinkRegions;
+            logOnce(`✅ Added SKExternalPurchaseLinkStreamingRegions: ${options.streamingLinkRegions.join(', ')}`);
+        }
+        return config;
+    });
+    return config;
+};
+exports.withIosAlternativeBilling = withIosAlternativeBilling;
 /** Ensure Podfile uses CocoaPods CDN and no stale local OpenIAP entry remains. */
-const withIapIOS = (config) => {
+const withIapIOS = (config, options) => {
+    // Add iOS alternative billing configuration if provided
+    if (options) {
+        config = withIosAlternativeBilling(config, options);
+    }
     return (0, config_plugins_1.withDangerousMod)(config, [
         'ios',
         async (config) => {
@@ -168,12 +229,15 @@ const withIap = (config, options) => {
                     ? resolved
                     : `ios=${resolved.ios ?? 'auto'}, android=${resolved.android ?? 'auto'}`;
                 logOnce(`🔧 [expo-iap] Enabling local OpenIAP: ${preview}`);
-                result = (0, withLocalOpenIAP_1.default)(result, { localPath: resolved });
+                result = (0, withLocalOpenIAP_1.default)(result, {
+                    localPath: resolved,
+                    iosAlternativeBilling: options?.iosAlternativeBilling,
+                });
             }
         }
         else {
             // Ensure iOS Podfile is set up to resolve public CocoaPods specs
-            result = withIapIOS(result);
+            result = withIapIOS(result, options?.iosAlternativeBilling);
             logOnce('📦 [expo-iap] Using OpenIAP from CocoaPods');
         }
         return result;

package/plugin/build/withLocalOpenIAP.d.ts

@@ -1,4 +1,5 @@
 import { ConfigPlugin } from 'expo/config-plugins';
+import type { IOSAlternativeBillingConfig } from './withIAP';
 /**
  * Plugin to add local OpenIAP pod dependency for development
  * This is only for local development with openiap-apple library
@@ -9,5 +10,6 @@ type LocalPathOption = string | {
 };
 declare const withLocalOpenIAP: ConfigPlugin<{
     localPath?: LocalPathOption;
+    iosAlternativeBilling?: IOSAlternativeBillingConfig;
 } | void>;
 export default withLocalOpenIAP;

package/plugin/build/withLocalOpenIAP.js

@@ -37,6 +37,13 @@ const config_plugins_1 = require("expo/config-plugins");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const withLocalOpenIAP = (config, props) => {
+    // Import and apply iOS alternative billing configuration if provided
+    if (props?.iosAlternativeBilling) {
+        // Import withIosAlternativeBilling from withIAP module
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { withIosAlternativeBilling } = require('./withIAP');
+        config = withIosAlternativeBilling(config, props.iosAlternativeBilling);
+    }
     // Helper to resolve Android module path
     const resolveAndroidModulePath = (p) => {
         if (!p)

package/plugin/src/withIAP.ts

@@ -5,6 +5,8 @@ import {
   withAndroidManifest,
   withAppBuildGradle,
   withDangerousMod,
+  withEntitlementsPlist,
+  withInfoPlist,
 } from 'expo/config-plugins';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -137,8 +139,133 @@ const withIapAndroid: ConfigPlugin<{addDeps?: boolean} | void> = (
   return config;
 };
 
+export interface IOSAlternativeBillingConfig {
+  /** Country codes where external purchases are supported (ISO 3166-1 alpha-2) */
+  countries?: string[];
+  /** External purchase URLs per country (iOS 15.4+) */
+  links?: Record<string, string>;
+  /** Multiple external purchase URLs per country (iOS 17.5+, up to 5 per country) */
+  multiLinks?: Record<string, string[]>;
+  /** Custom link regions (iOS 18.1+) */
+  customLinkRegions?: string[];
+  /** Streaming link regions for music apps (iOS 18.2+) */
+  streamingLinkRegions?: string[];
+  /** Enable external purchase link entitlement */
+  enableExternalPurchaseLink?: boolean;
+  /** Enable external purchase link streaming entitlement (music apps only) */
+  enableExternalPurchaseLinkStreaming?: boolean;
+}
+
+/** Add external purchase entitlements and Info.plist configuration */
+const withIosAlternativeBilling: ConfigPlugin<
+  IOSAlternativeBillingConfig | undefined
+> = (config, options) => {
+  if (!options || !options.countries || options.countries.length === 0) {
+    return config;
+  }
+
+  // Add entitlements
+  config = withEntitlementsPlist(config, (config) => {
+    // Always add basic external purchase entitlement when countries are specified
+    config.modResults['com.apple.developer.storekit.external-purchase'] = true;
+    logOnce(
+      '✅ Added com.apple.developer.storekit.external-purchase to entitlements',
+    );
+
+    // Add external purchase link entitlement if enabled
+    if (options.enableExternalPurchaseLink) {
+      config.modResults['com.apple.developer.storekit.external-purchase-link'] =
+        true;
+      logOnce(
+        '✅ Added com.apple.developer.storekit.external-purchase-link to entitlements',
+      );
+    }
+
+    // Add streaming entitlement if enabled
+    if (options.enableExternalPurchaseLinkStreaming) {
+      config.modResults[
+        'com.apple.developer.storekit.external-purchase-link-streaming'
+      ] = true;
+      logOnce(
+        '✅ Added com.apple.developer.storekit.external-purchase-link-streaming to entitlements',
+      );
+    }
+
+    return config;
+  });
+
+  // Add Info.plist configuration
+  config = withInfoPlist(config, (config) => {
+    const plist = config.modResults;
+
+    // 1. SKExternalPurchase (Required)
+    plist.SKExternalPurchase = options.countries;
+    logOnce(
+      `✅ Added SKExternalPurchase with countries: ${options.countries?.join(
+        ', ',
+      )}`,
+    );
+
+    // 2. SKExternalPurchaseLink (Optional - iOS 15.4+)
+    if (options.links && Object.keys(options.links).length > 0) {
+      plist.SKExternalPurchaseLink = options.links;
+      logOnce(
+        `✅ Added SKExternalPurchaseLink for ${
+          Object.keys(options.links).length
+        } countries`,
+      );
+    }
+
+    // 3. SKExternalPurchaseMultiLink (iOS 17.5+)
+    if (options.multiLinks && Object.keys(options.multiLinks).length > 0) {
+      plist.SKExternalPurchaseMultiLink = options.multiLinks;
+      logOnce(
+        `✅ Added SKExternalPurchaseMultiLink for ${
+          Object.keys(options.multiLinks).length
+        } countries`,
+      );
+    }
+
+    // 4. SKExternalPurchaseCustomLinkRegions (iOS 18.1+)
+    if (options.customLinkRegions && options.customLinkRegions.length > 0) {
+      plist.SKExternalPurchaseCustomLinkRegions = options.customLinkRegions;
+      logOnce(
+        `✅ Added SKExternalPurchaseCustomLinkRegions: ${options.customLinkRegions.join(
+          ', ',
+        )}`,
+      );
+    }
+
+    // 5. SKExternalPurchaseLinkStreamingRegions (iOS 18.2+)
+    if (
+      options.streamingLinkRegions &&
+      options.streamingLinkRegions.length > 0
+    ) {
+      plist.SKExternalPurchaseLinkStreamingRegions =
+        options.streamingLinkRegions;
+      logOnce(
+        `✅ Added SKExternalPurchaseLinkStreamingRegions: ${options.streamingLinkRegions.join(
+          ', ',
+        )}`,
+      );
+    }
+
+    return config;
+  });
+
+  return config;
+};
+
 /** Ensure Podfile uses CocoaPods CDN and no stale local OpenIAP entry remains. */
-const withIapIOS: ConfigPlugin = (config) => {
+const withIapIOS: ConfigPlugin<IOSAlternativeBillingConfig | undefined> = (
+  config,
+  options,
+) => {
+  // Add iOS alternative billing configuration if provided
+  if (options) {
+    config = withIosAlternativeBilling(config, options);
+  }
+
   return withDangerousMod(config, [
     'ios',
     async (config) => {
@@ -182,6 +309,13 @@ export interface ExpoIapPluginOptions {
       };
   /** Enable local development mode */
   enableLocalDev?: boolean;
+  /**
+   * iOS Alternative Billing configuration.
+   * Configure external purchase countries, links, and entitlements.
+   * Requires approval from Apple.
+   * @platform ios
+   */
+  iosAlternativeBilling?: IOSAlternativeBillingConfig;
 }
 
 const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
@@ -218,11 +352,14 @@ const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
                 resolved.android ?? 'auto'
               }`;
         logOnce(`🔧 [expo-iap] Enabling local OpenIAP: ${preview}`);
-        result = withLocalOpenIAP(result, {localPath: resolved});
+        result = withLocalOpenIAP(result, {
+          localPath: resolved,
+          iosAlternativeBilling: options?.iosAlternativeBilling,
+        });
       }
     } else {
       // Ensure iOS Podfile is set up to resolve public CocoaPods specs
-      result = withIapIOS(result);
+      result = withIapIOS(result, options?.iosAlternativeBilling);
       logOnce('📦 [expo-iap] Using OpenIAP from CocoaPods');
     }
 
@@ -237,4 +374,5 @@ const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
   }
 };
 
+export {withIosAlternativeBilling};
 export default createRunOncePlugin(withIap, pkg.name, pkg.version);

package/plugin/src/withLocalOpenIAP.ts

@@ -6,6 +6,7 @@ import {
 } from 'expo/config-plugins';
 import * as fs from 'fs';
 import * as path from 'path';
+import type {IOSAlternativeBillingConfig} from './withIAP';
 
 /**
  * Plugin to add local OpenIAP pod dependency for development
@@ -13,10 +14,19 @@ import * as path from 'path';
  */
 type LocalPathOption = string | {ios?: string; android?: string};
 
-const withLocalOpenIAP: ConfigPlugin<{localPath?: LocalPathOption} | void> = (
-  config,
-  props,
-) => {
+const withLocalOpenIAP: ConfigPlugin<
+  {
+    localPath?: LocalPathOption;
+    iosAlternativeBilling?: IOSAlternativeBillingConfig;
+  } | void
+> = (config, props) => {
+  // Import and apply iOS alternative billing configuration if provided
+  if (props?.iosAlternativeBilling) {
+    // Import withIosAlternativeBilling from withIAP module
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const {withIosAlternativeBilling} = require('./withIAP');
+    config = withIosAlternativeBilling(config, props.iosAlternativeBilling);
+  }
   // Helper to resolve Android module path
   const resolveAndroidModulePath = (p?: string): string | null => {
     if (!p) return null;

package/plugin/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/expoConfig.augmentation.d.ts","./src/withIAP.ts","./src/withLocalOpenIAP.ts"],"version":"5.9.2"}
+{"root":["./src/expoConfig.augmentation.d.ts","./src/withIAP.ts","./src/withLocalOpenIAP.ts"],"version":"5.9.3"}

package/src/index.ts

@@ -37,6 +37,7 @@ import type {
   RequestSubscriptionPropsByPlatforms,
   RequestSubscriptionAndroidProps,
   RequestSubscriptionIosProps,
+  UserChoiceBillingDetails,
 } from './types';
 import {ErrorCode} from './types';
 import {createPurchaseError, type PurchaseError} from './utils/errorMapping';
@@ -57,12 +58,14 @@ export enum OpenIapEvent {
   PurchaseUpdated = 'purchase-updated',
   PurchaseError = 'purchase-error',
   PromotedProductIOS = 'promoted-product-ios',
+  UserChoiceBillingAndroid = 'user-choice-billing-android',
 }
 
 type ExpoIapEventPayloads = {
   [OpenIapEvent.PurchaseUpdated]: Purchase;
   [OpenIapEvent.PurchaseError]: PurchaseError;
   [OpenIapEvent.PromotedProductIOS]: Product;
+  [OpenIapEvent.UserChoiceBillingAndroid]: UserChoiceBillingDetails;
 };
 
 type ExpoIapEventListener<E extends OpenIapEvent> = (
@@ -193,8 +196,45 @@ export const promotedProductListenerIOS = (
   return emitter.addListener(OpenIapEvent.PromotedProductIOS, listener);
 };
 
-export const initConnection: MutationField<'initConnection'> = async () =>
-  ExpoIapModule.initConnection();
+/**
+ * Android-only listener for User Choice Billing events.
+ * This fires when a user selects alternative billing instead of Google Play billing
+ * in the User Choice Billing dialog (only in 'user-choice' mode).
+ *
+ * @param listener - Callback function that receives the external transaction token and product IDs
+ * @returns EventSubscription that can be used to unsubscribe
+ *
+ * @example
+ * ```typescript
+ * const subscription = userChoiceBillingListenerAndroid((details) => {
+ *   console.log('User selected alternative billing');
+ *   console.log('Token:', details.externalTransactionToken);
+ *   console.log('Products:', details.products);
+ *
+ *   // Process payment in your system, then report token to Google
+ *   await processPaymentAndReportToken(details);
+ * });
+ *
+ * // Later, clean up
+ * subscription.remove();
+ * ```
+ *
+ * @platform Android
+ */
+export const userChoiceBillingListenerAndroid = (
+  listener: (details: UserChoiceBillingDetails) => void,
+) => {
+  if (Platform.OS !== 'android') {
+    ExpoIapConsole.warn(
+      'userChoiceBillingListenerAndroid: This listener is only available on Android',
+    );
+    return {remove: () => {}};
+  }
+  return emitter.addListener(OpenIapEvent.UserChoiceBillingAndroid, listener);
+};
+
+export const initConnection: MutationField<'initConnection'> = async (config) =>
+  ExpoIapModule.initConnection(config ?? null);
 
 export const endConnection: MutationField<'endConnection'> = async () =>
   ExpoIapModule.endConnection();
@@ -375,21 +415,16 @@ export const requestPurchase: MutationField<'requestPurchase'> = async (
       );
     }
 
-    let payload: MutationRequestPurchaseArgs;
-    if (canonical === 'in-app') {
-      payload = {
-        type: 'in-app',
-        request: request as RequestPurchasePropsByPlatforms,
-      };
-    } else if (canonical === 'subs') {
-      payload = {
-        type: 'subs',
-        request: request as RequestSubscriptionPropsByPlatforms,
-      };
-    } else {
+    if (canonical !== 'in-app' && canonical !== 'subs') {
       throw new Error(`Unsupported product type: ${canonical}`);
     }
 
+    const payload: MutationRequestPurchaseArgs = {
+      type: canonical === 'in-app' ? 'in-app' : 'subs',
+      request,
+      useAlternativeBilling: args.useAlternativeBilling,
+    };
+
     const purchase = (await ExpoIapModule.requestPurchase(payload)) as
       | Purchase
       | Purchase[]

package/src/modules/android.ts

@@ -163,3 +163,86 @@ export const acknowledgePurchaseAndroid: MutationField<
 export const openRedeemOfferCodeAndroid = async (): Promise<void> => {
   return Linking.openURL(`https://play.google.com/redeem?code=`);
 };
+
+/**
+ * Check if alternative billing is available for this user/device (Android only).
+ * Step 1 of alternative billing flow.
+ *
+ * Returns true if available, false otherwise.
+ * Throws OpenIapError.NotPrepared if billing client not ready.
+ *
+ * @returns {Promise<boolean>}
+ *
+ * @example
+ * ```typescript
+ * const isAvailable = await checkAlternativeBillingAvailabilityAndroid();
+ * if (isAvailable) {
+ *   // Proceed with alternative billing flow
+ * }
+ * ```
+ */
+export const checkAlternativeBillingAvailabilityAndroid: MutationField<
+  'checkAlternativeBillingAvailabilityAndroid'
+> = async () => {
+  return ExpoIapModule.checkAlternativeBillingAvailabilityAndroid();
+};
+
+/**
+ * Show alternative billing information dialog to user (Android only).
+ * Step 2 of alternative billing flow.
+ * Must be called BEFORE processing payment in your payment system.
+ *
+ * Returns true if user accepted, false if user canceled.
+ * Throws OpenIapError.NotPrepared if billing client not ready.
+ *
+ * @returns {Promise<boolean>}
+ *
+ * @example
+ * ```typescript
+ * const userAccepted = await showAlternativeBillingDialogAndroid();
+ * if (userAccepted) {
+ *   // Process payment in your payment system
+ *   const success = await processCustomPayment();
+ *   if (success) {
+ *     // Create reporting token
+ *     const token = await createAlternativeBillingTokenAndroid();
+ *     // Send token to your backend for Google Play reporting
+ *   }
+ * }
+ * ```
+ */
+export const showAlternativeBillingDialogAndroid: MutationField<
+  'showAlternativeBillingDialogAndroid'
+> = async () => {
+  return ExpoIapModule.showAlternativeBillingDialogAndroid();
+};
+
+/**
+ * Create external transaction token for Google Play reporting (Android only).
+ * Step 3 of alternative billing flow.
+ * Must be called AFTER successful payment in your payment system.
+ * Token must be reported to Google Play backend within 24 hours.
+ *
+ * Returns token string, or null if creation failed.
+ * Throws OpenIapError.NotPrepared if billing client not ready.
+ *
+ * @param {string} sku - The product SKU that was purchased
+ * @returns {Promise<string | null>}
+ *
+ * @example
+ * ```typescript
+ * const token = await createAlternativeBillingTokenAndroid('premium_subscription');
+ * if (token) {
+ *   // Send token to your backend
+ *   await fetch('/api/report-transaction', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ token, sku: 'premium_subscription' })
+ *   });
+ * }
+ * ```
+ */
+export const createAlternativeBillingTokenAndroid: MutationField<
+  'createAlternativeBillingTokenAndroid'
+> = async (sku?: string) => {
+  return ExpoIapModule.createAlternativeBillingTokenAndroid(sku);
+};