react-native-iap 14.4.46 → 14.5.0

package/src/specs/RnIap.nitro.ts

@@ -14,9 +14,9 @@ import type {
   ProductCommon,
   PurchaseCommon,
   PurchaseOptions,
-  ReceiptValidationAndroidOptions,
-  ReceiptValidationProps,
-  ReceiptValidationResultAndroid,
+  VerifyPurchaseAndroidOptions,
+  VerifyPurchaseProps,
+  VerifyPurchaseResultAndroid,
   RequestPurchaseIosProps,
   RequestPurchaseResult,
   RequestSubscriptionAndroidProps,
@@ -24,6 +24,26 @@ import type {
   PaymentModeIOS,
 } from '../types';
 
+// Nitro-compatible enum types (Nitro doesn't support inline string unions from types.ts)
+export type IapPlatform = 'ios' | 'android';
+
+export type IapkitPurchaseState =
+  | 'entitled'
+  | 'pending-acknowledgment'
+  | 'pending'
+  | 'canceled'
+  | 'expired'
+  | 'ready-to-consume'
+  | 'consumed'
+  | 'unknown'
+  | 'inauthentic';
+
+// IapStore enum for purchase store identification
+export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
+
+// Note: Nitro requires at least 2 values for union types
+export type PurchaseVerificationProvider = 'iapkit' | 'none';
+
 // ╔══════════════════════════════════════════════════════════════════════════╗
 // ║                                  PARAMS                                  ║
 // ╚══════════════════════════════════════════════════════════════════════════╝
@@ -31,14 +51,14 @@ import type {
 // Receipt validation parameters
 
 export interface NitroReceiptValidationAndroidOptions {
-  accessToken: ReceiptValidationAndroidOptions['accessToken'];
-  isSub?: ReceiptValidationAndroidOptions['isSub'];
-  packageName: ReceiptValidationAndroidOptions['packageName'];
-  productToken: ReceiptValidationAndroidOptions['productToken'];
+  accessToken: VerifyPurchaseAndroidOptions['accessToken'];
+  isSub?: VerifyPurchaseAndroidOptions['isSub'];
+  packageName: VerifyPurchaseAndroidOptions['packageName'];
+  productToken: VerifyPurchaseAndroidOptions['productToken'];
 }
 
 export interface NitroReceiptValidationParams {
-  sku: ReceiptValidationProps['sku'];
+  sku: VerifyPurchaseProps['sku'];
   androidOptions?: NitroReceiptValidationAndroidOptions | null;
 }
 
@@ -66,8 +86,14 @@ export interface NitroRequestPurchaseAndroid {
 }
 
 export interface NitroPurchaseRequest {
+  /** @deprecated Use apple instead */
   ios?: NitroRequestPurchaseIos | null;
+  /** @deprecated Use google instead */
   android?: NitroRequestPurchaseAndroid | null;
+  /** Apple-specific purchase parameters */
+  apple?: NitroRequestPurchaseIos | null;
+  /** Google-specific purchase parameters */
+  google?: NitroRequestPurchaseAndroid | null;
 }
 
 // Available purchases parameters
@@ -165,24 +191,64 @@ export interface NitroReceiptValidationResultIOS {
 }
 
 export interface NitroReceiptValidationResultAndroid {
-  autoRenewing: ReceiptValidationResultAndroid['autoRenewing'];
-  betaProduct: ReceiptValidationResultAndroid['betaProduct'];
-  cancelDate: ReceiptValidationResultAndroid['cancelDate'];
-  cancelReason: ReceiptValidationResultAndroid['cancelReason'];
-  deferredDate: ReceiptValidationResultAndroid['deferredDate'];
-  deferredSku: ReceiptValidationResultAndroid['deferredSku'];
-  freeTrialEndDate: ReceiptValidationResultAndroid['freeTrialEndDate'];
-  gracePeriodEndDate: ReceiptValidationResultAndroid['gracePeriodEndDate'];
-  parentProductId: ReceiptValidationResultAndroid['parentProductId'];
-  productId: ReceiptValidationResultAndroid['productId'];
-  productType: ReceiptValidationResultAndroid['productType'];
-  purchaseDate: ReceiptValidationResultAndroid['purchaseDate'];
-  quantity: ReceiptValidationResultAndroid['quantity'];
-  receiptId: ReceiptValidationResultAndroid['receiptId'];
-  renewalDate: ReceiptValidationResultAndroid['renewalDate'];
-  term: ReceiptValidationResultAndroid['term'];
-  termSku: ReceiptValidationResultAndroid['termSku'];
-  testTransaction: ReceiptValidationResultAndroid['testTransaction'];
+  autoRenewing: VerifyPurchaseResultAndroid['autoRenewing'];
+  betaProduct: VerifyPurchaseResultAndroid['betaProduct'];
+  cancelDate: VerifyPurchaseResultAndroid['cancelDate'];
+  cancelReason: VerifyPurchaseResultAndroid['cancelReason'];
+  deferredDate: VerifyPurchaseResultAndroid['deferredDate'];
+  deferredSku: VerifyPurchaseResultAndroid['deferredSku'];
+  freeTrialEndDate: VerifyPurchaseResultAndroid['freeTrialEndDate'];
+  gracePeriodEndDate: VerifyPurchaseResultAndroid['gracePeriodEndDate'];
+  parentProductId: VerifyPurchaseResultAndroid['parentProductId'];
+  productId: VerifyPurchaseResultAndroid['productId'];
+  productType: VerifyPurchaseResultAndroid['productType'];
+  purchaseDate: VerifyPurchaseResultAndroid['purchaseDate'];
+  quantity: VerifyPurchaseResultAndroid['quantity'];
+  receiptId: VerifyPurchaseResultAndroid['receiptId'];
+  renewalDate: VerifyPurchaseResultAndroid['renewalDate'];
+  term: VerifyPurchaseResultAndroid['term'];
+  termSku: VerifyPurchaseResultAndroid['termSku'];
+  testTransaction: VerifyPurchaseResultAndroid['testTransaction'];
+}
+
+// VerifyPurchaseWithProvider types
+
+export interface NitroVerifyPurchaseWithIapkitAppleProps {
+  /** The JWS token returned with the purchase response. */
+  jws: string;
+}
+
+export interface NitroVerifyPurchaseWithIapkitGoogleProps {
+  /** The token provided to the user's device when the product or subscription was purchased. */
+  purchaseToken: string;
+}
+
+export interface NitroVerifyPurchaseWithIapkitProps {
+  apiKey?: string | null;
+  apple?: NitroVerifyPurchaseWithIapkitAppleProps | null;
+  google?: NitroVerifyPurchaseWithIapkitGoogleProps | null;
+}
+
+export interface NitroVerifyPurchaseWithProviderProps {
+  iapkit?: NitroVerifyPurchaseWithIapkitProps | null;
+  provider: PurchaseVerificationProvider;
+}
+
+export interface NitroVerifyPurchaseWithIapkitResult {
+  isValid: boolean;
+  state: IapkitPurchaseState;
+  store: IapStore;
+}
+
+export interface NitroVerifyPurchaseWithProviderError {
+  code?: string | null;
+  message: string;
+}
+
+export interface NitroVerifyPurchaseWithProviderResult {
+  iapkit?: NitroVerifyPurchaseWithIapkitResult | null;
+  errors?: NitroVerifyPurchaseWithProviderError[] | null;
+  provider: PurchaseVerificationProvider;
 }
 
 /**
@@ -199,7 +265,10 @@ export interface NitroPurchase {
   productId: PurchaseCommon['productId'];
   transactionDate: PurchaseCommon['transactionDate'];
   purchaseToken?: PurchaseCommon['purchaseToken'];
-  platform: PurchaseCommon['platform'];
+  /** @deprecated Use store instead */
+  platform: IapPlatform;
+  /** Store where purchase was made */
+  store: IapStore;
   quantity: PurchaseCommon['quantity'];
   purchaseState: PurchaseCommon['purchaseState'];
   isAutoRenewing: PurchaseCommon['isAutoRenewing'];
@@ -288,7 +357,7 @@ export interface NitroProduct {
   displayPrice?: ProductCommon['displayPrice'];
   currency?: ProductCommon['currency'];
   price?: ProductCommon['price'];
-  platform: ProductCommon['platform'];
+  platform: IapPlatform;
   // iOS specific fields
   typeIOS?: string | null;
   isFamilyShareableIOS?: boolean | null;
@@ -378,6 +447,13 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
     subscriptionIds?: string[],
   ): Promise<NitroActiveSubscription[]>;
 
+  /**
+   * Check if there are any active subscriptions
+   * @param subscriptionIds - Optional array of subscription IDs to filter
+   * @returns Promise<boolean> - True if there are active subscriptions
+   */
+  hasActiveSubscriptions(subscriptionIds?: string[]): Promise<boolean>;
+
   /**
    * Finish a transaction (unified method for both platforms)
    * @param params - Platform-specific transaction finish parameters
@@ -646,6 +722,19 @@ export interface RnIap extends HybridObject<{ios: 'swift'; android: 'kotlin'}> {
     NitroReceiptValidationResultIOS | NitroReceiptValidationResultAndroid
   >;
 
+  /**
+   * 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 params - Verification options including provider and credentials
+   * @returns Promise<NitroVerifyPurchaseWithProviderResult> - Provider-specific verification result
+   */
+  verifyPurchaseWithProvider(
+    params: NitroVerifyPurchaseWithProviderProps,
+  ): Promise<NitroVerifyPurchaseWithProviderResult>;
+
   /**
    * Get the storefront country/region code for the current user.
    * @returns Promise<string> - The storefront country code (e.g., "USA")

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';
 
+export type IapStore = 'unknown' | 'apple' | 'google' | 'horizon';
+
+/** Unified purchase states from IAPKit verification response. */
+export type IapkitPurchaseState = 'entitled' | 'pending-acknowledgment' | 'pending' | 'canceled' | 'expired' | 'ready-to-consume' | 'consumed' | 'unknown' | 'inauthentic';
+
 /** 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;
@@ -433,12 +457,18 @@ export interface PurchaseAndroid extends PurchaseCommon {
   obfuscatedAccountIdAndroid?: (string | null);
   obfuscatedProfileIdAndroid?: (string | null);
   packageNameAndroid?: (string | null);
+  /**
+   * @deprecated Use store instead
+   * @deprecated Use store instead
+   */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
   purchaseToken?: (string | null);
   quantity: number;
   signatureAndroid?: (string | null);
+  /** Store where purchase was made */
+  store: IapStore;
   transactionDate: number;
   transactionId?: (string | null);
 }
@@ -454,12 +484,18 @@ export interface PurchaseCommon {
   id: string;
   ids?: (string[] | null);
   isAutoRenewing: boolean;
+  /**
+   * @deprecated Use store instead
+   * @deprecated Use store instead
+   */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
   /** Unified purchase token (iOS JWS, Android purchaseToken) */
   purchaseToken?: (string | null);
   quantity: number;
+  /** Store where purchase was made */
+  store: IapStore;
   transactionDate: number;
 }
 
@@ -486,6 +522,10 @@ export interface PurchaseIOS extends PurchaseCommon {
   originalTransactionDateIOS?: (number | null);
   originalTransactionIdentifierIOS?: (string | null);
   ownershipTypeIOS?: (string | null);
+  /**
+   * @deprecated Use store instead
+   * @deprecated Use store instead
+   */
   platform: IapPlatform;
   productId: string;
   purchaseState: PurchaseState;
@@ -497,6 +537,8 @@ export interface PurchaseIOS extends PurchaseCommon {
   renewalInfoIOS?: (RenewalInfoIOS | null);
   revocationDateIOS?: (number | null);
   revocationReasonIOS?: (string | null);
+  /** Store where purchase was made */
+  store: IapStore;
   storefrontCountryCodeIOS?: (string | null);
   subscriptionGroupIdIOS?: (string | null);
   transactionDate: number;
@@ -522,6 +564,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 +604,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 +633,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);
@@ -729,9 +728,13 @@ export type RequestPurchaseProps =
     };
 
 export interface RequestPurchasePropsByPlatforms {
-  /** Android-specific purchase parameters */
+  /** @deprecated Use google instead */
   android?: (RequestPurchaseAndroidProps | null);
-  /** iOS-specific purchase parameters */
+  /** Apple-specific purchase parameters */
+  apple?: (RequestPurchaseIosProps | null);
+  /** Google-specific purchase parameters */
+  google?: (RequestPurchaseAndroidProps | null);
+  /** @deprecated Use apple instead */
   ios?: (RequestPurchaseIosProps | null);
 }
 
@@ -763,12 +766,43 @@ export interface RequestSubscriptionIosProps {
 }
 
 export interface RequestSubscriptionPropsByPlatforms {
-  /** Android-specific subscription parameters */
+  /** @deprecated Use google instead */
   android?: (RequestSubscriptionAndroidProps | null);
-  /** iOS-specific subscription parameters */
+  /** Apple-specific subscription parameters */
+  apple?: (RequestSubscriptionIosProps | null);
+  /** Google-specific subscription parameters */
+  google?: (RequestSubscriptionAndroidProps | null);
+  /** @deprecated Use apple instead */
   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: IapStore;
+}
+
 export interface Subscription {
   /** Fires when the App Store surfaces a promoted product (iOS only) */
   promotedProductIOS: string;
@@ -826,6 +860,72 @@ 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 VerifyPurchaseWithProviderError {
+  code?: (string | null);
+  message: string;
+}
+
+export interface VerifyPurchaseWithProviderProps {
+  iapkit?: (RequestVerifyPurchaseWithIapkitProps | null);
+  provider: PurchaseVerificationProvider;
+}
+
+export interface VerifyPurchaseWithProviderResult {
+  /** Error details if verification failed */
+  errors?: (VerifyPurchaseWithProviderError[] | null);
+  /** IAPKit verification result */
+  iapkit?: (RequestVerifyPurchaseWithIapkitResult | null);
+  provider: PurchaseVerificationProvider;
+}
+
 export type VoidResult = void;
 
 // -- Query helper types (auto-generated)
@@ -884,6 +984,8 @@ export type MutationArgsMap = {
   showManageSubscriptionsIOS: never;
   syncIOS: never;
   validateReceipt: MutationValidateReceiptArgs;
+  verifyPurchase: MutationVerifyPurchaseArgs;
+  verifyPurchaseWithProvider: MutationVerifyPurchaseWithProviderArgs;
 };
 
 export type MutationField<K extends keyof Mutation> =

package/src/utils/errorMapping.ts

@@ -11,6 +11,18 @@ const ERROR_CODE_ALIASES: Record<string, ErrorCode> = {
   USER_CANCELED: ErrorCode.UserCancelled,
   E_USER_CANCELLED: ErrorCode.UserCancelled,
   USER_CANCELLED: ErrorCode.UserCancelled,
+  // Deprecated error code mappings (map old Receipt* codes to new PurchaseVerification* codes)
+  // These ensure backwards compatibility while preferring new codes
+  RECEIPT_FAILED: ErrorCode.PurchaseVerificationFailed,
+  E_RECEIPT_FAILED: ErrorCode.PurchaseVerificationFailed,
+  RECEIPT_FINISHED: ErrorCode.PurchaseVerificationFinished,
+  E_RECEIPT_FINISHED: ErrorCode.PurchaseVerificationFinished,
+  RECEIPT_FINISHED_FAILED: ErrorCode.PurchaseVerificationFinishFailed,
+  E_RECEIPT_FINISHED_FAILED: ErrorCode.PurchaseVerificationFinishFailed,
+  // Also handle kebab-case versions
+  'receipt-failed': ErrorCode.PurchaseVerificationFailed,
+  'receipt-finished': ErrorCode.PurchaseVerificationFinished,
+  'receipt-finished-failed': ErrorCode.PurchaseVerificationFinishFailed,
 };
 
 const toKebabCase = (str: string): string => {
@@ -86,6 +98,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 = {
@@ -293,8 +310,6 @@ export function getUserFriendlyErrorMessage(error: ErrorLike): string {
       return 'Purchase cancelled';
     case ErrorCode.NetworkError:
       return 'Network connection error. Please check your internet connection and try again.';
-    case ErrorCode.ReceiptFinished:
-      return 'Receipt already finished';
     case ErrorCode.ServiceDisconnected:
       return 'Billing service disconnected. Please try again.';
     case ErrorCode.BillingUnavailable:
@@ -320,7 +335,14 @@ export function getUserFriendlyErrorMessage(error: ErrorLike): string {
     case ErrorCode.TransactionValidationFailed:
       return 'Transaction could not be verified';
     case ErrorCode.ReceiptFailed:
-      return 'Receipt processing failed';
+    case ErrorCode.PurchaseVerificationFailed:
+      return 'Purchase verification failed';
+    case ErrorCode.ReceiptFinished:
+    case ErrorCode.PurchaseVerificationFinished:
+      return 'Purchase verification completed';
+    case ErrorCode.ReceiptFinishedFailed:
+    case ErrorCode.PurchaseVerificationFinishFailed:
+      return 'Failed to complete purchase verification';
     case ErrorCode.EmptySkuList:
       return 'No product IDs provided';
     case ErrorCode.InitConnection:
@@ -345,12 +367,18 @@ export const normalizeErrorCodeFromNative = (code: unknown): ErrorCode => {
   if (typeof code === 'string') {
     const upper = code.toUpperCase();
 
-    // Check aliases first
+    // Check aliases first (includes deprecated Receipt* -> PurchaseVerification* mappings)
     const alias = ERROR_CODE_ALIASES[upper];
     if (alias) {
       return alias;
     }
 
+    // Also check lowercase alias for kebab-case codes
+    const lowerAlias = ERROR_CODE_ALIASES[code];
+    if (lowerAlias) {
+      return lowerAlias;
+    }
+
     // Handle various user cancelled formats
     if (
       upper === 'USER_CANCELLED' ||