expo-iap 4.4.0-rc.7 → 4.4.0

package/CHANGELOG.md

@@ -1,3 +1,6 @@
 # CHANGELOG
 
-[Check release notes](https://github.com/hyochan/expo-iap/releases)
+OpenIAP keeps detailed release history centralized to avoid package-local drift.
+
+- Consolidated release notes: [openiap.dev/docs/updates/releases](https://openiap.dev/docs/updates/releases)
+- Expo package releases: [hyodotdev/openiap/releases?q=expo-iap](https://github.com/hyodotdev/openiap/releases?q=expo-iap&expanded=true)

package/README.md

@@ -85,7 +85,7 @@ Expo IAP conforms to the **[OpenIAP specification](https://openiap.dev)** — an
 
 - **Shared specification** — Common types, error codes, and purchase flows across all platforms
 - **Generated type-safe bindings** — Swift, Kotlin, Dart, and GDScript from a single GraphQL schema
-- **Platform implementations** — [openiap-apple](https://github.com/hyodotdev/openiap/tree/main/packages/apple) (StoreKit 2) and [openiap-google](https://github.com/hyodotdev/openiap/tree/main/packages/google) (Play Billing 8.x)
+- **Platform implementations** — [openiap-apple](https://github.com/hyodotdev/openiap/tree/main/packages/apple) (StoreKit 2) and [openiap-google](https://github.com/hyodotdev/openiap/tree/main/packages/google) (Play Billing 9.1.0)
 - **Verification profiles** — Standardized receipt validation and purchase verification patterns
 
 Other libraries built on OpenIAP: [react-native-iap](https://github.com/hyodotdev/openiap/tree/main/libraries/react-native-iap) · [flutter_inapp_purchase](https://github.com/hyodotdev/openiap/tree/main/libraries/flutter_inapp_purchase) · [kmp-iap](https://github.com/hyodotdev/openiap/tree/main/libraries/kmp-iap) · [godot-iap](https://github.com/hyodotdev/openiap/tree/main/libraries/godot-iap)

package/android/src/main/java/expo/modules/iap/ExpoIapHelper.kt

@@ -1,6 +1,7 @@
 package expo.modules.iap
 
 import dev.hyo.openiap.AndroidSubscriptionOfferInput
+import dev.hyo.openiap.DeveloperBillingOptionParamsAndroid
 import dev.hyo.openiap.OpenIapError
 import dev.hyo.openiap.OpenIapModule
 import dev.hyo.openiap.ProductQueryType
@@ -102,7 +103,15 @@ object ExpoIapHelper {
                 }
             } ?: emptyList()
         val purchaseToken = effective["purchaseToken"] as? String
+        val originalExternalTransactionId = effective["originalExternalTransactionId"] as? String
         val replacementMode = effective["replacementMode"] as? Number
+        val developerBillingOption =
+            (effective["developerBillingOption"] as? Map<*, *>)?.let { optionMap ->
+                val json = optionMap.entries.mapNotNull { (key, value) ->
+                    (key as? String)?.let { it to value }
+                }.toMap()
+                DeveloperBillingOptionParamsAndroid.fromJson(json)
+            }
         val subscriptionProductReplacementParams =
             (effective["subscriptionProductReplacementParams"] as? Map<*, *>)?.let { paramsMap ->
                 val oldProductId = paramsMap["oldProductId"] as? String
@@ -128,6 +137,8 @@ object ExpoIapHelper {
             offerToken = offerToken,
             offerTokenArr = offerTokenArr,
             explicitSubscriptionOffers = explicitSubscriptionOffers,
+            developerBillingOption = developerBillingOption,
+            originalExternalTransactionId = originalExternalTransactionId,
             purchaseToken = purchaseToken,
             replacementMode = replacementMode,
             subscriptionProductReplacementParams = subscriptionProductReplacementParams,
@@ -155,6 +166,8 @@ object ExpoIapHelper {
         val offerToken: String?,
         val offerTokenArr: List<String>,
         val explicitSubscriptionOffers: List<AndroidSubscriptionOfferInput>,
+        val developerBillingOption: DeveloperBillingOptionParamsAndroid?,
+        val originalExternalTransactionId: String?,
         val purchaseToken: String?,
         val replacementMode: Number?,
         val subscriptionProductReplacementParams: SubscriptionProductReplacementParamsAndroid?,
@@ -306,7 +319,7 @@ object ExpoIapHelper {
                 "USER_CHOICE_BILLING",
             )
         }
-        // Developer Provided Billing listener for External Payments (8.3.0+)
+        // Developer Provided Billing listener for External Payments (8.3.0+) and Billing Choice (9.1.0+)
         openIap.addDeveloperProvidedBillingListener { details ->
             safeEmitEvent(
                 module,

package/android/src/main/java/expo/modules/iap/ExpoIapModule.kt

@@ -36,9 +36,15 @@ import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 import java.util.concurrent.ConcurrentLinkedQueue
 import java.util.concurrent.atomic.AtomicBoolean
+import dev.hyo.openiap.BillingChoiceImageLayoutAndroid as OpenIapBillingChoiceImageLayout
+import dev.hyo.openiap.BillingProgramInformationDialogParamsAndroid as OpenIapBillingProgramInformationDialogParams
 import dev.hyo.openiap.BillingProgramAndroid as OpenIapBillingProgram
+import dev.hyo.openiap.DeveloperBillingTypeAndroid as OpenIapDeveloperBillingType
 import dev.hyo.openiap.ExternalLinkLaunchModeAndroid as OpenIapExternalLinkLaunchMode
 import dev.hyo.openiap.ExternalLinkTypeAndroid as OpenIapExternalLinkType
+import dev.hyo.openiap.GetBillingChoiceInfoParamsAndroid as OpenIapGetBillingChoiceInfoParams
+import dev.hyo.openiap.InAppMessageCategoryAndroid as OpenIapInAppMessageCategory
+import dev.hyo.openiap.InAppMessageParamsAndroid as OpenIapInAppMessageParams
 import dev.hyo.openiap.LaunchExternalLinkParamsAndroid as OpenIapLaunchExternalLinkParams
 
 class ExpoIapModule : Module() {
@@ -280,6 +286,8 @@ class ExpoIapModule : Module() {
                                     isOfferPersonalized = parsedParams.isOfferPersonalized,
                                     obfuscatedAccountId = parsedParams.obfuscatedAccountId,
                                     obfuscatedProfileId = parsedParams.obfuscatedProfileId,
+                                    developerBillingOption = parsedParams.developerBillingOption,
+                                    originalExternalTransactionId = parsedParams.originalExternalTransactionId,
                                     purchaseToken = parsedParams.purchaseToken,
                                     replacementMode = parsedParams.replacementMode?.toInt(),
                                     skus = parsedParams.skus,
@@ -289,7 +297,7 @@ class ExpoIapModule : Module() {
                             RequestPurchaseProps(
                                 request =
                                     RequestPurchaseProps.Request.Subscription(
-                                        RequestSubscriptionPropsByPlatforms(android = android),
+                                        RequestSubscriptionPropsByPlatforms(google = android),
                                     ),
                                 type = ProductQueryType.Subs,
                             )
@@ -301,13 +309,14 @@ class ExpoIapModule : Module() {
                                     isOfferPersonalized = parsedParams.isOfferPersonalized,
                                     obfuscatedAccountId = parsedParams.obfuscatedAccountId,
                                     obfuscatedProfileId = parsedParams.obfuscatedProfileId,
+                                    developerBillingOption = parsedParams.developerBillingOption,
                                     offerToken = parsedParams.offerToken,
                                     skus = parsedParams.skus,
                                 )
                             RequestPurchaseProps(
                                 request =
                                     RequestPurchaseProps.Request.Purchase(
-                                        RequestPurchasePropsByPlatforms(android = android),
+                                        RequestPurchasePropsByPlatforms(google = android),
                                     ),
                                 type = ProductQueryType.InApp,
                             )
@@ -569,8 +578,10 @@ class ExpoIapModule : Module() {
                         val result = openIapStore.isBillingProgramAvailable(openIapProgram)
                         val response =
                             mapOf(
-                                "billingProgram" to program,
+                                "billingProgram" to result.billingProgram.toJson(),
+                                "choiceScreenType" to result.choiceScreenType?.toJson(),
                                 "isAvailable" to result.isAvailable,
+                                "isExternalLinkAvailable" to result.isExternalLinkAvailable,
                             )
                         ExpoIapLog.result("isBillingProgramAvailableAndroid", response)
                         promise.resolve(response)
@@ -581,12 +592,41 @@ class ExpoIapModule : Module() {
                 }
             }
 
-            AsyncFunction("createBillingProgramReportingDetailsAndroid") { program: String, promise: Promise ->
-                ExpoIapLog.payload("createBillingProgramReportingDetailsAndroid", mapOf("program" to program))
+            AsyncFunction("getBillingChoiceInfoAndroid") { params: Map<String, Any?>, promise: Promise ->
+                ExpoIapLog.payload("getBillingChoiceInfoAndroid", params)
+                scope.launch {
+                    try {
+                        val request =
+                            OpenIapGetBillingChoiceInfoParams(
+                                billingProgram = mapBillingProgram(params["billingProgram"] as? String ?: "billing-choice"),
+                                playBillingChoiceImageLayout = mapBillingChoiceImageLayout(
+                                    params["playBillingChoiceImageLayout"] as? String ?: "rectangular-four-by-one",
+                                ),
+                                userLocale = params["userLocale"] as? String,
+                            )
+                        val result = openIapStore.getBillingChoiceInfo(request)
+                        ExpoIapLog.result("getBillingChoiceInfoAndroid", mapOf("hasImageUrl" to result.playBillingChoiceImageUrl.isNotBlank()))
+                        promise.resolve(result.toJson())
+                    } catch (e: Exception) {
+                        ExpoIapLog.failure("getBillingChoiceInfoAndroid", e)
+                        promise.reject(OpenIapError.ServiceUnavailable.CODE, e.message, e)
+                    }
+                }
+            }
+
+            AsyncFunction("createBillingProgramReportingDetailsAndroid") { program: String, developerBillingType: String?, promise: Promise ->
+                ExpoIapLog.payload(
+                    "createBillingProgramReportingDetailsAndroid",
+                    mapOf("program" to program, "developerBillingType" to developerBillingType),
+                )
                 scope.launch {
                     try {
                         val openIapProgram = mapBillingProgram(program)
-                        val result = openIapStore.createBillingProgramReportingDetails(openIapProgram)
+                        val result =
+                            openIapStore.createBillingProgramReportingDetails(
+                                openIapProgram,
+                                mapDeveloperBillingType(developerBillingType),
+                            )
                         val response =
                             mapOf(
                                 "billingProgram" to program,
@@ -604,6 +644,74 @@ class ExpoIapModule : Module() {
                 }
             }
 
+            AsyncFunction("showBillingProgramInformationDialogAndroid") { params: Map<String, Any?>, promise: Promise ->
+                ExpoIapLog.payload("showBillingProgramInformationDialogAndroid", params)
+                scope.launch {
+                    try {
+                        val activity =
+                            runCatching { currentActivity }
+                                .onFailure {
+                                    ExpoIapLog.failure("showBillingProgramInformationDialogAndroid activity", it)
+                                }.getOrNull() ?: run {
+                                promise.reject(OpenIapError.ServiceUnavailable.CODE, "Activity not available", null)
+                                return@launch
+                            }
+                        val token = params["externalTransactionToken"] as? String
+                        if (token.isNullOrBlank()) {
+                            promise.reject(OpenIapError.DeveloperError.CODE, "`externalTransactionToken` is a required parameter.", null)
+                            return@launch
+                        }
+                        val result =
+                            openIapStore.showBillingProgramInformationDialog(
+                                activity,
+                                OpenIapBillingProgramInformationDialogParams(
+                                    billingProgram = mapBillingProgram(params["billingProgram"] as? String ?: "billing-choice"),
+                                    externalTransactionToken = token,
+                                ),
+                            )
+                        ExpoIapLog.result("showBillingProgramInformationDialogAndroid", result.toJson())
+                        promise.resolve(result.toJson())
+                    } catch (e: Exception) {
+                        ExpoIapLog.failure("showBillingProgramInformationDialogAndroid", e)
+                        promise.reject(OpenIapError.ServiceUnavailable.CODE, e.message, e)
+                    }
+                }
+            }
+
+            AsyncFunction("showInAppMessagesAndroid") { params: Map<String, Any?>?, promise: Promise ->
+                ExpoIapLog.payload("showInAppMessagesAndroid", params ?: emptyMap<String, Any?>())
+                scope.launch {
+                    try {
+                        val activity =
+                            runCatching { currentActivity }
+                                .onFailure {
+                                    ExpoIapLog.failure("showInAppMessagesAndroid activity", it)
+                                }.getOrNull() ?: run {
+                                promise.reject(OpenIapError.ServiceUnavailable.CODE, "Activity not available", null)
+                                return@launch
+                            }
+                        val categories =
+                            (params?.get("categories") as? List<*>)
+                                ?.map { entry ->
+                                    val category = entry as? String
+                                        ?: throw IllegalArgumentException("In-app message category must be a string: $entry")
+                                    mapInAppMessageCategory(category)
+                                        ?: throw IllegalArgumentException("Unknown in-app message category: $category")
+                                }
+                        val result =
+                            openIapStore.showInAppMessages(
+                                activity,
+                                OpenIapInAppMessageParams(categories = categories),
+                            )
+                        ExpoIapLog.result("showInAppMessagesAndroid", result.toJson())
+                        promise.resolve(result.toJson())
+                    } catch (e: Exception) {
+                        ExpoIapLog.failure("showInAppMessagesAndroid", e)
+                        promise.reject(OpenIapError.ServiceUnavailable.CODE, e.message, e)
+                    }
+                }
+            }
+
             AsyncFunction("launchExternalLinkAndroid") { params: Map<String, Any?>, promise: Promise ->
                 ExpoIapLog.payload("launchExternalLinkAndroid", params)
                 scope.launch {
@@ -618,6 +726,7 @@ class ExpoIapModule : Module() {
                             }
 
                         val billingProgram = params["billingProgram"] as? String
+                        val externalTransactionToken = params["externalTransactionToken"] as? String
                         val launchMode = params["launchMode"] as? String ?: "unspecified"
                         val linkType = params["linkType"] as? String ?: "unspecified"
                         val linkUri = params["linkUri"] as? String
@@ -635,6 +744,7 @@ class ExpoIapModule : Module() {
                         val openIapParams =
                             OpenIapLaunchExternalLinkParams(
                                 billingProgram = mapBillingProgram(billingProgram),
+                                externalTransactionToken = externalTransactionToken,
                                 launchMode = mapExternalLinkLaunchMode(launchMode),
                                 linkType = mapExternalLinkType(linkType),
                                 linkUri = linkUri,
@@ -666,9 +776,31 @@ class ExpoIapModule : Module() {
             "external-content-link" -> OpenIapBillingProgram.ExternalContentLink
             "external-payments" -> OpenIapBillingProgram.ExternalPayments
             "user-choice-billing" -> OpenIapBillingProgram.UserChoiceBilling
+            "billing-choice" -> OpenIapBillingProgram.BillingChoice
             else -> OpenIapBillingProgram.Unspecified
         }
 
+    private fun mapBillingChoiceImageLayout(layout: String): OpenIapBillingChoiceImageLayout =
+        when (layout) {
+            "rectangular-three-by-one" -> OpenIapBillingChoiceImageLayout.RectangularThreeByOne
+            "rectangular-two-by-two" -> OpenIapBillingChoiceImageLayout.RectangularTwoByTwo
+            else -> OpenIapBillingChoiceImageLayout.RectangularFourByOne
+        }
+
+    private fun mapDeveloperBillingType(type: String?): OpenIapDeveloperBillingType? =
+        when (type) {
+            "in-app" -> OpenIapDeveloperBillingType.InApp
+            "external-link" -> OpenIapDeveloperBillingType.ExternalLink
+            else -> null
+        }
+
+    private fun mapInAppMessageCategory(category: String): OpenIapInAppMessageCategory? =
+        when (category) {
+            "unknown-in-app-message-category-id" -> OpenIapInAppMessageCategory.UnknownInAppMessageCategoryId
+            "transactional" -> OpenIapInAppMessageCategory.Transactional
+            else -> null
+        }
+
     private fun mapExternalLinkLaunchMode(mode: String): OpenIapExternalLinkLaunchMode =
         when (mode) {
             "launch-in-external-browser-or-app" -> OpenIapExternalLinkLaunchMode.LaunchInExternalBrowserOrApp

package/build/index.d.ts

@@ -11,8 +11,8 @@ export declare enum OpenIapEvent {
     PromotedProductIOS = "promoted-product-ios",
     UserChoiceBillingAndroid = "user-choice-billing-android",
     /**
-     * Fired when user selects developer billing in External Payments flow (Android 8.3.0+)
-     * Only available in Japan. Contains externalTransactionToken for reporting.
+     * Fired for External Payments (8.3.0+) and Billing Choice (9.1.0+)
+     * developer billing flows. Nullable fields depend on the selected flow.
      */
     DeveloperProvidedBillingAndroid = "developer-provided-billing-android",
     /**
@@ -103,33 +103,29 @@ export declare const userChoiceBillingListenerAndroid: (listener: (details: User
     remove: () => void;
 };
 /**
- * Android-only listener for Developer Provided Billing events (External Payments).
- * This fires when a user selects the developer's payment option in the External Payments
- * side-by-side choice dialog during purchase flow.
+ * Android-only listener for Developer Provided Billing events.
+ * This fires when a user selects the developer's option in an External Payments
+ * or Billing Choice purchase flow.
  *
- * Requires Google Play Billing Library 8.3.0+ and is currently only available in Japan.
+ * Requires Google Play Billing Library 8.3.0+; Billing Choice fields require 9.1.0+.
  *
- * @param listener - Callback function that receives the external transaction token
+ * @param listener - Callback that receives selected products and flow details
  * @returns EventSubscription that can be used to unsubscribe
  *
  * @example
  * ```typescript
  * const subscription = developerProvidedBillingListenerAndroid(async (details) => {
- *   console.log('User selected developer billing');
- *   console.log('External transaction token received; send it to your backend without logging it.');
- *
- *   // Process payment with your payment gateway
- *   await processPaymentWithYourGateway(details.externalTransactionToken);
- *
- *   // IMPORTANT: Report the token to Google Play within 24 hours
- *   await reportExternalTransactionToGoogle(details.externalTransactionToken);
+ *   await processPaymentWithYourGateway(details.products, details.linkUri);
+ *   if (details.externalTransactionToken) {
+ *     await reportExternalTransactionToGoogle(details.externalTransactionToken);
+ *   }
  * });
  *
  * // Later, clean up
  * subscription.remove();
  * ```
  *
- * @platform Android (8.3.0+, Japan only)
+ * @platform Android (8.3.0+; Billing Choice 9.1.0+)
  */
 export declare const developerProvidedBillingListenerAndroid: (listener: (details: DeveloperProvidedBillingDetailsAndroid) => void) => {
     remove: () => void;
@@ -164,7 +160,9 @@ export declare const subscriptionBillingIssueListener: (listener: (purchase: Pur
  * Initialize the store connection. Must be called before any other IAP API.
  *
  * @param config Optional connection config. Use `enableBillingProgramAndroid` (Android,
- *   Play Billing 8.2.0+) to opt into External Payments etc. iOS ignores Android-specific fields.
+ *   Play Billing 8.2.0+) to opt into a billing program. For Billing Choice 9.1.0+, set
+ *   `billingChoiceScreenTypeAndroid` to the renderer configured in Play Console.
+ *   iOS ignores Android-specific fields.
  * @returns Promise resolving to `true` when the platform billing client is connected.
  * @throws When the platform billing client fails to initialize.
  *
@@ -172,6 +170,10 @@ export declare const subscriptionBillingIssueListener: (listener: (purchase: Pur
  * ```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 —

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -22,8 +22,8 @@ export var OpenIapEvent;
     OpenIapEvent["PromotedProductIOS"] = "promoted-product-ios";
     OpenIapEvent["UserChoiceBillingAndroid"] = "user-choice-billing-android";
     /**
-     * Fired when user selects developer billing in External Payments flow (Android 8.3.0+)
-     * Only available in Japan. Contains externalTransactionToken for reporting.
+     * Fired for External Payments (8.3.0+) and Billing Choice (9.1.0+)
+     * developer billing flows. Nullable fields depend on the selected flow.
      */
     OpenIapEvent["DeveloperProvidedBillingAndroid"] = "developer-provided-billing-android";
     /**
@@ -308,33 +308,29 @@ export const userChoiceBillingListenerAndroid = (listener) => {
     return emitter.addListener(OpenIapEvent.UserChoiceBillingAndroid, listener);
 };
 /**
- * Android-only listener for Developer Provided Billing events (External Payments).
- * This fires when a user selects the developer's payment option in the External Payments
- * side-by-side choice dialog during purchase flow.
+ * Android-only listener for Developer Provided Billing events.
+ * This fires when a user selects the developer's option in an External Payments
+ * or Billing Choice purchase flow.
  *
- * Requires Google Play Billing Library 8.3.0+ and is currently only available in Japan.
+ * Requires Google Play Billing Library 8.3.0+; Billing Choice fields require 9.1.0+.
  *
- * @param listener - Callback function that receives the external transaction token
+ * @param listener - Callback that receives selected products and flow details
  * @returns EventSubscription that can be used to unsubscribe
  *
  * @example
  * ```typescript
  * const subscription = developerProvidedBillingListenerAndroid(async (details) => {
- *   console.log('User selected developer billing');
- *   console.log('External transaction token received; send it to your backend without logging it.');
- *
- *   // Process payment with your payment gateway
- *   await processPaymentWithYourGateway(details.externalTransactionToken);
- *
- *   // IMPORTANT: Report the token to Google Play within 24 hours
- *   await reportExternalTransactionToGoogle(details.externalTransactionToken);
+ *   await processPaymentWithYourGateway(details.products, details.linkUri);
+ *   if (details.externalTransactionToken) {
+ *     await reportExternalTransactionToGoogle(details.externalTransactionToken);
+ *   }
  * });
  *
  * // Later, clean up
  * subscription.remove();
  * ```
  *
- * @platform Android (8.3.0+, Japan only)
+ * @platform Android (8.3.0+; Billing Choice 9.1.0+)
  */
 export const developerProvidedBillingListenerAndroid = (listener) => {
     if (Platform.OS !== 'android') {
@@ -378,7 +374,9 @@ export const subscriptionBillingIssueListener = (listener) => {
  * Initialize the store connection. Must be called before any other IAP API.
  *
  * @param config Optional connection config. Use `enableBillingProgramAndroid` (Android,
- *   Play Billing 8.2.0+) to opt into External Payments etc. iOS ignores Android-specific fields.
+ *   Play Billing 8.2.0+) to opt into a billing program. For Billing Choice 9.1.0+, set
+ *   `billingChoiceScreenTypeAndroid` to the renderer configured in Play Console.
+ *   iOS ignores Android-specific fields.
  * @returns Promise resolving to `true` when the platform billing client is connected.
  * @throws When the platform billing client fails to initialize.
  *
@@ -386,6 +384,10 @@ export const subscriptionBillingIssueListener = (listener) => {
  * ```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 —
@@ -679,7 +681,7 @@ export const requestPurchase = async (args) => {
                     '  })\n\n' +
                     'See: https://openiap.dev/docs/apis/request-purchase');
             }
-            const { skus, obfuscatedAccountId, obfuscatedProfileId, isOfferPersonalized, offerToken, } = normalizedRequest;
+            const { skus, obfuscatedAccountId, obfuscatedProfileId, isOfferPersonalized, offerToken, developerBillingOption, } = normalizedRequest;
             const result = (await ExpoIapModule.requestPurchase({
                 type: native,
                 skuArr: skus,
@@ -688,6 +690,7 @@ export const requestPurchase = async (args) => {
                 obfuscatedAccountId: obfuscatedAccountId,
                 obfuscatedProfileId: obfuscatedProfileId,
                 offerToken: offerToken,
+                developerBillingOption: developerBillingOption ?? undefined,
                 offerTokenArr: [],
                 isOfferPersonalized: isOfferPersonalized ?? false,
             }));
@@ -707,7 +710,7 @@ export const requestPurchase = async (args) => {
                     '  })\n\n' +
                     'See: https://openiap.dev/docs/apis/request-purchase');
             }
-            const { skus, obfuscatedAccountId, obfuscatedProfileId, isOfferPersonalized, subscriptionOffers, replacementMode: replacementModeInput, purchaseToken: purchaseTokenInput, subscriptionProductReplacementParams, } = normalizedRequest;
+            const { skus, obfuscatedAccountId, obfuscatedProfileId, isOfferPersonalized, subscriptionOffers, replacementMode: replacementModeInput, purchaseToken: purchaseTokenInput, originalExternalTransactionId, developerBillingOption, subscriptionProductReplacementParams, } = normalizedRequest;
             const normalizedOffers = subscriptionOffers ?? [];
             const replacementMode = replacementModeInput ?? -1;
             const purchaseToken = purchaseTokenInput ?? undefined;
@@ -715,12 +718,14 @@ export const requestPurchase = async (args) => {
                 type: native,
                 skuArr: skus,
                 purchaseToken,
+                originalExternalTransactionId: originalExternalTransactionId ?? undefined,
                 replacementMode,
                 obfuscatedAccountId: obfuscatedAccountId,
                 obfuscatedProfileId: obfuscatedProfileId,
                 offerTokenArr: normalizedOffers.map((offer) => offer.offerToken),
                 subscriptionOffers: normalizedOffers,
                 isOfferPersonalized: isOfferPersonalized ?? false,
+                developerBillingOption: developerBillingOption ?? undefined,
                 subscriptionProductReplacementParams: subscriptionProductReplacementParams ?? undefined,
             }));
             return normalizePurchaseArray(result);