expo-iap 3.1.35 → 3.1.37

package/ios/ExpoIapHelper.swift

@@ -1,6 +1,24 @@
+import ExpoModulesCore
 import Foundation
 import OpenIAP
 
+/// Exception wrapper for PurchaseError that preserves OpenIAP error codes
+/// This ensures consistent error format between try-catch and onPurchaseError callback
+class IapException: GenericException<(code: String, message: String, productId: String?)> {
+    override var code: String { param.code }
+    override var reason: String { param.message }
+
+    var productId: String? { param.productId }
+
+    static func from(_ error: PurchaseError) -> IapException {
+        let payload = OpenIapSerialization.encode(error)
+        let code = payload["code"] as? String ?? "unknown"
+        let message = payload["message"] as? String ?? error.localizedDescription
+        let productId = payload["productId"] as? String
+        return IapException((code: code, message: message, productId: productId))
+    }
+}
+
 enum ExpoIapHelper {
     private static var listeners: [Subscription] = []
 

package/ios/ExpoIapModule.swift

@@ -13,9 +13,9 @@ public final class ExpoIapModule: Module {
     nonisolated public func definition() -> ModuleDefinition {
         Name("ExpoIap")
 
-        Constants([
-            "ERROR_CODES": OpenIapSerialization.errorCodes()
-        ])
+        Constant("ERROR_CODES") {
+            OpenIapSerialization.errorCodes()
+        }
 
         Events(
             OpenIapEvent.purchaseUpdated.rawValue,
@@ -61,10 +61,8 @@ 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 {
@@ -86,10 +84,11 @@ public final class ExpoIapModule: Module {
                 }
             } catch let error as PurchaseError {
                 ExpoIapLog.failure("requestPurchase", error: error)
-                throw error
+                throw IapException.from(error)
             } catch {
                 ExpoIapLog.failure("requestPurchase", error: error)
-                throw PurchaseError.make(code: .purchaseError, message: error.localizedDescription)
+                throw IapException.from(
+                    PurchaseError.make(code: .purchaseError, message: error.localizedDescription))
             }
         }
 
@@ -189,18 +188,60 @@ public final class ExpoIapModule: Module {
             ExpoIapLog.payload("validateReceiptIOS", payload: ["sku": sku])
             try await ExpoIapHelper.ensureConnection(isInitialized: self.isInitialized)
             do {
-                let props = try OpenIapSerialization.receiptValidationProps(from: ["sku": sku])
-                let result = try await OpenIapModule.shared.validateReceiptIOS(props)
+                let props = try OpenIapSerialization.verifyPurchaseProps(from: ["sku": sku])
+                let result = try await OpenIapModule.shared.verifyPurchase(props)
                 var payload = OpenIapSerialization.encode(result)
-                payload["purchaseToken"] = result.jwsRepresentation
+
+                // Extract jwsRepresentation from the result
+                if case .verifyPurchaseResultIos(let iosResult) = result {
+                    payload["purchaseToken"] = iosResult.jwsRepresentation
+                }
+
                 let sanitized = ExpoIapHelper.sanitizeDictionary(payload)
                 ExpoIapLog.result("validateReceiptIOS", value: sanitized)
                 return sanitized
             } catch let error as PurchaseError {
                 ExpoIapLog.failure("validateReceiptIOS", error: error)
-                throw error
+                throw IapException.from(error)
             } catch {
                 ExpoIapLog.failure("validateReceiptIOS", error: error)
+                throw IapException.from(PurchaseError.make(code: .receiptFailed))
+            }
+        }
+
+        AsyncFunction("verifyPurchase") { (params: [String: Any]) async throws -> [String: Any] in
+            ExpoIapLog.payload("verifyPurchase", payload: params)
+            try await ExpoIapHelper.ensureConnection(isInitialized: self.isInitialized)
+            do {
+                let props = try OpenIapSerialization.verifyPurchaseProps(from: params)
+                let result = try await OpenIapModule.shared.verifyPurchase(props)
+                let sanitized = ExpoIapHelper.sanitizeDictionary(OpenIapSerialization.encode(result))
+                ExpoIapLog.result("verifyPurchase", value: sanitized)
+                return sanitized
+            } catch let error as PurchaseError {
+                ExpoIapLog.failure("verifyPurchase", error: error)
+                throw error
+            } catch {
+                ExpoIapLog.failure("verifyPurchase", error: error)
+                throw PurchaseError.make(code: .receiptFailed)
+            }
+        }
+
+        AsyncFunction("verifyPurchaseWithProvider") { (params: [String: Any]) async throws -> [String: Any] in
+            ExpoIapLog.payload("verifyPurchaseWithProvider", payload: params)
+            try await ExpoIapHelper.ensureConnection(isInitialized: self.isInitialized)
+            do {
+                let jsonData = try JSONSerialization.data(withJSONObject: params)
+                let props = try JSONDecoder().decode(VerifyPurchaseWithProviderProps.self, from: jsonData)
+                let result = try await OpenIapModule.shared.verifyPurchaseWithProvider(props)
+                let sanitized = ExpoIapHelper.sanitizeDictionary(OpenIapSerialization.encode(result))
+                ExpoIapLog.result("verifyPurchaseWithProvider", value: sanitized)
+                return sanitized
+            } catch let error as PurchaseError {
+                ExpoIapLog.failure("verifyPurchaseWithProvider", error: error)
+                throw error
+            } catch {
+                ExpoIapLog.failure("verifyPurchaseWithProvider", error: error)
                 throw PurchaseError.make(code: .receiptFailed)
             }
         }
@@ -312,10 +353,10 @@ public final class ExpoIapModule: Module {
                 return nil
             } catch let error as PurchaseError {
                 ExpoIapLog.failure("currentEntitlementIOS", error: error)
-                throw error
+                throw IapException.from(error)
             } catch {
                 ExpoIapLog.failure("currentEntitlementIOS", error: error)
-                throw PurchaseError.make(code: .skuNotFound, productId: sku)
+                throw IapException.from(PurchaseError.make(code: .skuNotFound, productId: sku))
             }
         }
 
@@ -332,10 +373,10 @@ public final class ExpoIapModule: Module {
                 return nil
             } catch let error as PurchaseError {
                 ExpoIapLog.failure("latestTransactionIOS", error: error)
-                throw error
+                throw IapException.from(error)
             } catch {
                 ExpoIapLog.failure("latestTransactionIOS", error: error)
-                throw PurchaseError.make(code: .skuNotFound, productId: sku)
+                throw IapException.from(PurchaseError.make(code: .skuNotFound, productId: sku))
             }
         }
 

package/openiap-versions.json

@@ -1,5 +1,5 @@
 {
-  "apple": "1.2.39",
-  "google": "1.3.7",
-  "gql": "1.2.5"
+  "apple": "1.2.41",
+  "google": "1.3.8",
+  "gql": "1.2.7"
 }

package/package.json

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

package/src/index.ts

@@ -708,6 +708,8 @@ export const deepLinkToSubscriptions: MutationField<
  * For production apps, always validate receipts on your secure server:
  * - iOS: Send receipt data to Apple's verification endpoint from your server
  * - Android: Use Google Play Developer API with service account credentials
+ *
+ * @deprecated Use verifyPurchase instead
  */
 export const validateReceipt: MutationField<'validateReceipt'> = async (
   options,
@@ -741,6 +743,60 @@ export const validateReceipt: MutationField<'validateReceipt'> = async (
   throw new Error('Platform not supported');
 };
 
+/**
+ * Verify purchase with the configured providers
+ *
+ * This function uses the native OpenIAP verifyPurchase implementation
+ * which validates purchases using platform-specific methods.
+ *
+ * @param options - Receipt validation options containing the SKU
+ * @returns Promise resolving to receipt validation result
+ */
+export const verifyPurchase: MutationField<'verifyPurchase'> = async (
+  options,
+) => {
+  if (Platform.OS === 'ios' || Platform.OS === 'android') {
+    return ExpoIapModule.verifyPurchase(options);
+  }
+
+  throw new Error(`Unsupported platform: ${Platform.OS}`);
+};
+
+/**
+ * Verify purchase with a specific provider (e.g., IAPKit)
+ *
+ * This function allows you to verify purchases using external verification
+ * services like IAPKit, which provide additional validation and security.
+ *
+ * @param options - Verification options including provider and credentials
+ * @returns Promise resolving to provider-specific verification result
+ *
+ * @example
+ * ```typescript
+ * const result = await verifyPurchaseWithProvider({
+ *   provider: 'iapkit',
+ *   iapkit: {
+ *     apiKey: 'your-api-key',
+ *     apple: {
+ *       jws: purchase.purchaseToken // JWS from purchase
+ *     },
+ *     google: {
+ *       purchaseToken: purchase.purchaseToken
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export const verifyPurchaseWithProvider: MutationField<
+  'verifyPurchaseWithProvider'
+> = async (options) => {
+  if (Platform.OS === 'ios' || Platform.OS === 'android') {
+    return ExpoIapModule.verifyPurchaseWithProvider(options);
+  }
+
+  throw new Error(`Unsupported platform: ${Platform.OS}`);
+};
+
 export * from './useIAP';
 export {
   ErrorCodeUtils,

package/src/modules/android.ts

@@ -8,7 +8,7 @@ import ExpoIapModule from '../ExpoIapModule';
 import type {
   DeepLinkOptions,
   MutationField,
-  ReceiptValidationResultAndroid,
+  VerifyPurchaseResultAndroid,
 } from '../types';
 
 type NativeAndroidModule = {
@@ -80,6 +80,8 @@ export const deepLinkToSubscriptionsAndroid = async (
  * Validate receipt for Android. NOTE: This method is here for debugging purposes only. Including
  * your access token in the binary you ship to users is potentially dangerous.
  * Use server side validation instead for your production builds
+ *
+ * @deprecated Use verifyPurchase instead
  * @param {Object} params - The parameters object
  * @param {string} params.packageName - package name of your app.
  * @param {string} params.productId - product id for your in app product.
@@ -100,7 +102,7 @@ export const validateReceiptAndroid = async ({
   productToken: string;
   accessToken: string;
   isSub?: boolean;
-}): Promise<ReceiptValidationResultAndroid> => {
+}): Promise<VerifyPurchaseResultAndroid> => {
   const type = isSub ? 'subscriptions' : 'products';
 
   const url =

package/src/modules/ios.ts

@@ -13,8 +13,8 @@ import type {
   Purchase,
   PurchaseIOS,
   QueryField,
-  ReceiptValidationProps,
-  ReceiptValidationResultIOS,
+  VerifyPurchaseProps,
+  VerifyPurchaseResultIOS,
   SubscriptionStatusIOS,
 } from '../types';
 import type {PurchaseError} from '../utils/errorMapping';
@@ -226,7 +226,8 @@ export const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (
  * NOTE: For proper security, Apple recommends verifying receipts on your server using
  * the verifyReceipt endpoint rather than relying solely on client-side verification.
  *
- * @param {string} sku The product's SKU (on iOS)
+ * @deprecated Use verifyPurchase instead
+ * @param props The product's SKU or verification props
  * @returns {Promise<{
  *   isValid: boolean;
  *   receiptData: string;
@@ -234,11 +235,9 @@ export const getTransactionJwsIOS: QueryField<'getTransactionJwsIOS'> = async (
  *   latestTransaction?: Purchase;
  * }>}
  */
-const validateReceiptIOSImpl = async (
-  props: ReceiptValidationProps | string,
-) => {
+const validateReceiptIOSImpl = async (props: VerifyPurchaseProps | string) => {
   const sku =
-    typeof props === 'string' ? props : (props as ReceiptValidationProps)?.sku;
+    typeof props === 'string' ? props : (props as VerifyPurchaseProps)?.sku;
 
   if (!sku) {
     throw new Error('validateReceiptIOS requires a SKU');
@@ -246,7 +245,7 @@ const validateReceiptIOSImpl = async (
 
   return (await ExpoIapModule.validateReceiptIOS(
     sku,
-  )) as ReceiptValidationResultIOS;
+  )) as VerifyPurchaseResultIOS;
 };
 
 export const validateReceiptIOS =

package/src/types.ts

@@ -28,6 +28,11 @@ export interface ActiveSubscription {
   renewalInfoIOS?: (RenewalInfoIOS | null);
   transactionDate: number;
   transactionId: string;
+  /**
+   * @deprecated iOS only - use daysUntilExpirationIOS instead.
+   * Whether the subscription will expire soon (within 7 days).
+   * Consider using daysUntilExpirationIOS for more precise control.
+   */
   willExpireSoon?: (boolean | null);
 }
 
@@ -131,6 +136,9 @@ export enum ErrorCode {
   NotPrepared = 'not-prepared',
   Pending = 'pending',
   PurchaseError = 'purchase-error',
+  PurchaseVerificationFailed = 'purchase-verification-failed',
+  PurchaseVerificationFinishFailed = 'purchase-verification-finish-failed',
+  PurchaseVerificationFinished = 'purchase-verification-finished',
   QueryProduct = 'query-product',
   ReceiptFailed = 'receipt-failed',
   ReceiptFinished = 'receipt-finished',
@@ -172,6 +180,11 @@ export type IapEvent = 'purchase-updated' | 'purchase-error' | 'promoted-product
 
 export type IapPlatform = 'ios' | 'android';
 
+/** Unified purchase states from IAPKit verification response. */
+export type IapkitPurchaseState = 'entitled' | 'pending-acknowledgment' | 'pending' | 'canceled' | 'expired' | 'ready-to-consume' | 'consumed' | 'unknown' | 'inauthentic';
+
+export type IapkitStore = 'apple' | 'google';
+
 /** Connection initialization configuration */
 export interface InitConnectionConfig {
   /**
@@ -241,8 +254,15 @@ export interface Mutation {
   showManageSubscriptionsIOS: Promise<PurchaseIOS[]>;
   /** Force a StoreKit sync for transactions (iOS 15+) */
   syncIOS: Promise<boolean>;
-  /** Validate purchase receipts with the configured providers */
-  validateReceipt: Promise<ReceiptValidationResult>;
+  /**
+   * Validate purchase receipts with the configured providers
+   * @deprecated Use verifyPurchase
+   */
+  validateReceipt: Promise<VerifyPurchaseResult>;
+  /** Verify purchases with the configured providers */
+  verifyPurchase: Promise<VerifyPurchaseResult>;
+  /** Verify purchases with a specific provider (e.g., IAPKit) */
+  verifyPurchaseWithProvider: Promise<VerifyPurchaseWithProviderResult>;
 }
 
 
@@ -282,7 +302,11 @@ export type MutationRequestPurchaseArgs =
     };
 
 
-export type MutationValidateReceiptArgs = ReceiptValidationProps;
+export type MutationValidateReceiptArgs = VerifyPurchaseProps;
+
+export type MutationVerifyPurchaseArgs = VerifyPurchaseProps;
+
+export type MutationVerifyPurchaseWithProviderArgs = VerifyPurchaseWithProviderProps;
 
 export type PaymentModeIOS = 'empty' | 'free-trial' | 'pay-as-you-go' | 'pay-up-front';
 
@@ -330,11 +354,11 @@ export interface ProductCommon {
   displayName?: (string | null);
   displayPrice: string;
   id: string;
-  platform: IapPlatform;
+  platform: 'android' | 'ios';
   price?: (number | null);
   title: string;
-  type: ProductType;
-}
+  type: 'in-app' | 'subs';
+} 
 
 export interface ProductIOS extends ProductCommon {
   currency: string;
@@ -522,6 +546,8 @@ export interface PurchaseOptions {
 
 export type PurchaseState = 'pending' | 'purchased' | 'failed' | 'restored' | 'deferred' | 'unknown';
 
+export type PurchaseVerificationProvider = 'iapkit';
+
 export interface Query {
   /** Check if external purchase notice sheet can be presented (iOS 18.2+) */
   canPresentExternalPurchaseNoticeIOS: Promise<boolean>;
@@ -560,8 +586,11 @@ export interface Query {
   latestTransactionIOS?: Promise<(PurchaseIOS | null)>;
   /** Get StoreKit 2 subscription status details (iOS 15+) */
   subscriptionStatusIOS: Promise<SubscriptionStatusIOS[]>;
-  /** Validate a receipt for a specific product */
-  validateReceiptIOS: Promise<ReceiptValidationResultIOS>;
+  /**
+   * Validate a receipt for a specific product
+   * @deprecated Use verifyPurchase
+   */
+  validateReceiptIOS: Promise<VerifyPurchaseResultIOS>;
 }
 
 
@@ -586,55 +615,7 @@ export type QueryLatestTransactionIosArgs = string;
 
 export type QuerySubscriptionStatusIosArgs = string;
 
-export type QueryValidateReceiptIosArgs = ReceiptValidationProps;
-
-export interface ReceiptValidationAndroidOptions {
-  accessToken: string;
-  isSub?: (boolean | null);
-  packageName: string;
-  productToken: string;
-}
-
-export interface ReceiptValidationProps {
-  /** Android-specific validation options */
-  androidOptions?: (ReceiptValidationAndroidOptions | null);
-  /** Product SKU to validate */
-  sku: string;
-}
-
-export type ReceiptValidationResult = ReceiptValidationResultAndroid | ReceiptValidationResultIOS;
-
-export interface ReceiptValidationResultAndroid {
-  autoRenewing: boolean;
-  betaProduct: boolean;
-  cancelDate?: (number | null);
-  cancelReason?: (string | null);
-  deferredDate?: (number | null);
-  deferredSku?: (string | null);
-  freeTrialEndDate: number;
-  gracePeriodEndDate: number;
-  parentProductId: string;
-  productId: string;
-  productType: string;
-  purchaseDate: number;
-  quantity: number;
-  receiptId: string;
-  renewalDate: number;
-  term: string;
-  termSku: string;
-  testTransaction: boolean;
-}
-
-export interface ReceiptValidationResultIOS {
-  /** Whether the receipt is valid */
-  isValid: boolean;
-  /** JWS representation */
-  jwsRepresentation: string;
-  /** Latest transaction if available */
-  latestTransaction?: (Purchase | null);
-  /** Receipt data string */
-  receiptData: string;
-}
+export type QueryValidateReceiptIosArgs = VerifyPurchaseProps;
 
 export interface RefundResultIOS {
   message?: (string | null);
@@ -769,6 +750,33 @@ export interface RequestSubscriptionPropsByPlatforms {
   ios?: (RequestSubscriptionIosProps | null);
 }
 
+export interface RequestVerifyPurchaseWithIapkitAppleProps {
+  /** The JWS token returned with the purchase response. */
+  jws: string;
+}
+
+export interface RequestVerifyPurchaseWithIapkitGoogleProps {
+  /** The token provided to the user's device when the product or subscription was purchased. */
+  purchaseToken: string;
+}
+
+export interface RequestVerifyPurchaseWithIapkitProps {
+  /** API key used for the Authorization header (Bearer {apiKey}). */
+  apiKey?: (string | null);
+  /** Apple verification parameters. */
+  apple?: (RequestVerifyPurchaseWithIapkitAppleProps | null);
+  /** Google verification parameters. */
+  google?: (RequestVerifyPurchaseWithIapkitGoogleProps | null);
+}
+
+export interface RequestVerifyPurchaseWithIapkitResult {
+  /** Whether the purchase is valid (not falsified). */
+  isValid: boolean;
+  /** The current state of the purchase. */
+  state: IapkitPurchaseState;
+  store: IapkitStore;
+}
+
 export interface Subscription {
   /** Fires when the App Store surfaces a promoted product (iOS only) */
   promotedProductIOS: string;
@@ -826,6 +834,65 @@ export interface UserChoiceBillingDetails {
   products: string[];
 }
 
+export interface VerifyPurchaseAndroidOptions {
+  accessToken: string;
+  isSub?: (boolean | null);
+  packageName: string;
+  productToken: string;
+}
+
+export interface VerifyPurchaseProps {
+  /** Android-specific validation options */
+  androidOptions?: (VerifyPurchaseAndroidOptions | null);
+  /** Product SKU to validate */
+  sku: string;
+}
+
+export type VerifyPurchaseResult = VerifyPurchaseResultAndroid | VerifyPurchaseResultIOS;
+
+export interface VerifyPurchaseResultAndroid {
+  autoRenewing: boolean;
+  betaProduct: boolean;
+  cancelDate?: (number | null);
+  cancelReason?: (string | null);
+  deferredDate?: (number | null);
+  deferredSku?: (string | null);
+  freeTrialEndDate: number;
+  gracePeriodEndDate: number;
+  parentProductId: string;
+  productId: string;
+  productType: string;
+  purchaseDate: number;
+  quantity: number;
+  receiptId: string;
+  renewalDate: number;
+  term: string;
+  termSku: string;
+  testTransaction: boolean;
+}
+
+export interface VerifyPurchaseResultIOS {
+  /** Whether the receipt is valid */
+  isValid: boolean;
+  /** JWS representation */
+  jwsRepresentation: string;
+  /** Latest transaction if available */
+  latestTransaction?: (Purchase | null);
+  /** Receipt data string */
+  receiptData: string;
+}
+
+export interface VerifyPurchaseWithProviderProps {
+  iapkit?: (RequestVerifyPurchaseWithIapkitProps | null);
+  provider: PurchaseVerificationProvider;
+}
+
+export interface VerifyPurchaseWithProviderResult {
+  /** IAPKit verification results (can include Apple and Google entries) */
+  iapkit: RequestVerifyPurchaseWithIapkitResult[];
+  provider: PurchaseVerificationProvider;
+}
+
 export type VoidResult = void;
 
 // -- Query helper types (auto-generated)
@@ -884,6 +951,8 @@ export type MutationArgsMap = {
   showManageSubscriptionsIOS: never;
   syncIOS: never;
   validateReceipt: MutationValidateReceiptArgs;
+  verifyPurchase: MutationVerifyPurchaseArgs;
+  verifyPurchaseWithProvider: MutationVerifyPurchaseWithProviderArgs;
 };
 
 export type MutationField<K extends keyof Mutation> =

package/src/useIAP.ts

@@ -15,6 +15,8 @@ import {
   requestPurchase as requestPurchaseInternal,
   fetchProducts,
   validateReceipt as validateReceiptInternal,
+  verifyPurchase as verifyPurchaseInternal,
+  verifyPurchaseWithProvider as verifyPurchaseWithProviderInternal,
   getActiveSubscriptions,
   hasActiveSubscriptions,
   type ActiveSubscription,
@@ -41,8 +43,10 @@ import type {
   Purchase,
   MutationRequestPurchaseArgs,
   PurchaseInput,
-  ReceiptValidationProps,
-  ReceiptValidationResult,
+  VerifyPurchaseProps,
+  VerifyPurchaseResult,
+  VerifyPurchaseWithProviderProps,
+  VerifyPurchaseWithProviderResult,
   ProductAndroid,
   ProductSubscriptionIOS,
 } from './types';
@@ -77,9 +81,14 @@ type UseIap = {
   requestPurchase: (
     params: MutationRequestPurchaseArgs,
   ) => ReturnType<typeof requestPurchaseInternal>;
+  /** @deprecated Use verifyPurchase instead */
   validateReceipt: (
-    props: ReceiptValidationProps,
-  ) => Promise<ReceiptValidationResult>;
+    props: VerifyPurchaseProps,
+  ) => Promise<VerifyPurchaseResult>;
+  verifyPurchase: (props: VerifyPurchaseProps) => Promise<VerifyPurchaseResult>;
+  verifyPurchaseWithProvider: (
+    props: VerifyPurchaseWithProviderProps,
+  ) => Promise<VerifyPurchaseWithProviderResult>;
   restorePurchases: () => Promise<void>;
   getPromotedProductIOS: () => Promise<Product | null>;
   requestPurchaseOnPromotedProductIOS: () => Promise<boolean>;
@@ -383,10 +392,21 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     }
   }, []);
 
-  const validateReceipt = useCallback(async (props: ReceiptValidationProps) => {
+  const validateReceipt = useCallback(async (props: VerifyPurchaseProps) => {
     return validateReceiptInternal(props);
   }, []);
 
+  const verifyPurchase = useCallback(async (props: VerifyPurchaseProps) => {
+    return verifyPurchaseInternal(props);
+  }, []);
+
+  const verifyPurchaseWithProvider = useCallback(
+    async (props: VerifyPurchaseWithProviderProps) => {
+      return verifyPurchaseWithProviderInternal(props);
+    },
+    [],
+  );
+
   const initIapWithSubscriptions = useCallback(async (): Promise<void> => {
     // CRITICAL: Register listeners BEFORE initConnection to avoid race condition
     // Events might fire immediately after initConnection, so listeners must be ready
@@ -481,6 +501,8 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     fetchProducts: fetchProductsInternal,
     requestPurchase: requestPurchaseWithReset,
     validateReceipt,
+    verifyPurchase,
+    verifyPurchaseWithProvider,
     restorePurchases: restorePurchasesInternal,
     // internal getters kept for hook state management
     getPromotedProductIOS,

package/src/utils/errorMapping.ts

@@ -80,6 +80,11 @@ const COMMON_ERROR_CODE_MAP: Record<ErrorCode, string> = {
   [ErrorCode.BillingUnavailable]: ErrorCode.BillingUnavailable,
   [ErrorCode.FeatureNotSupported]: ErrorCode.FeatureNotSupported,
   [ErrorCode.EmptySkuList]: ErrorCode.EmptySkuList,
+  [ErrorCode.PurchaseVerificationFailed]: ErrorCode.PurchaseVerificationFailed,
+  [ErrorCode.PurchaseVerificationFinishFailed]:
+    ErrorCode.PurchaseVerificationFinishFailed,
+  [ErrorCode.PurchaseVerificationFinished]:
+    ErrorCode.PurchaseVerificationFinished,
 };
 
 export const ErrorCodeMapping = {