Changelog

[4.4.1] - 2022-08-11

Fixed

  • GooglePlay - Fixed NullReferenceException and ArgumentException that would rarely occur due to a concurrency issue introduced in Unity IAP 4.2.0
  • Amazon - Set android:export to true to support Android API level 31+

[4.4.0] - 2022-07-11

Added

  • GooglePlay - Google Play Billing Library version 4.0.0.
    • The Multi-quantity feature is not yet supported by the IAP package and will come in a future update. Do not enable Multi-quantity in the Google Play Console.
    • Add support for the IMMEDIATE_AND_CHARGE_FULL_PRICE proration mode. Use GooglePlayProrationMode.ImmediateAndChargeFullPrice for easy access.

Fixed

  • GooglePlay - Fix IGooglePlayConfiguration.SetDeferredPurchaseListener and IGooglePlayConfiguration.SetDeferredProrationUpgradeDowngradeSubscriptionListener callbacks sometimes not being called from the main thread.
  • GooglePlay - When configuring IGooglePlayConfiguration.SetQueryProductDetailsFailedListener(Action<int> retryCount), the action will be invoked with retryCount starting at 1 instead of 0.
  • GooglePlay - Added a validation when upgrading/downgrading a subscription that calls IStoreListener.OnPurchaseFailed with PurchaseFailureReason.ProductUnavailable when the old transaction id is empty or null. This can occur when attempting to upgrade/downgrade a subscription that the user doesn't own.

[4.3.0] - 2022-06-16

Added

  • GooglePlay - API IGooglePlayConfiguration.SetQueryProductDetailsFailedListener(Action<int>) called when Unity IAP fails to query product details. The Action will be called on each query product details failure with the retry count. See documentation "Store Guides" > "Google Play" for a sample usage.

[4.2.1] - 2022-06-14

Fixed

  • Downgrade com.unity.services.core from 1.4.1 to 1.3.1 due to a new bug found in 1.4.1

[4.2.0] - 2022-06-13

Added

  • Feature to automatically initialize Unity Gaming Services through the catalog UI. Please see the documentation for more details.

Changed

  • The In-App Purchasing package now requires Unity Gaming Services to have been initialized before it can be used. For the time being IAP will continue working as usual, but will log a warning if Unity Gaming Services has not been initialized. In future releases of this package, initializing Unity Gaming Services will be mandatory. Please see the documentation for more details.

[4.2.0-pre.2] - 2022-04-28

Added

Changed

  • The Analytics notice in the In-App Purchasing service window has been removed for Unity Editors 2022 and up.

[4.2.0-pre.1] - 2022-04-07

Added

  • Support for the new Unity Analytics transaction event.
  • The package will now send telemetry diagnostic and metric events to help improve the long-term reliability and performance of the package.

Changed

  • The minimum Unity Editor version supported is 2020.3.
  • The In-App Purchasing service window now links to the new Unity Dashboard for Unity Editors 2022 and up.

Fixed

  • GooglePlay - Fixed OnInitializeFailed never called if GooglePlay BillingClient is not ready during initialization.
  • GooglePlay - GoogleBilling is allowed to initialize correctly even if the user's Google account is logged out, so long as it is linked. The user will need to log in to their account to continue making purchases.
  • Fixed a build error DirectoryNotFoundException that occurred when the build platform was iOS or tvOS and the build target was another platform.

[4.1.5] - 2022-05-17

Fixed

  • GooglePlay - Fixed a null reference exception introduced in Unity IAP 4.1.4 that could happen when cancelling an in-app purchase.

[4.1.4] - 2022-03-30

Fixed

  • GooglePlay - Fixed issue where if an app is backgrounded while a purchase is being processed, an OnPurchaseFailed would be called with the purchase failure reason UserCancelled, even if the purchase was successful.

[4.1.3] - 2022-01-11

Fixed

  • Removed deprecated UnityWebRequest calls, updating them to use safer ones. This avoids compiler warnings that may occur.
  • Fixed a serious edge case where Apple StoreKit receipt parsing might fail, preventing validation. A portion of receipts on iOS could be affected and cause Unity IAP to freeze after the purchase completed, but before the SDK can finalize the purchase. The user will have to uninstall and reinstall your app in order to recover from this. Your customer service will have to refund the user's purchase or apply the purchase in some other way outside of Unity IAP. This bug was accidentally introduced in Unity IAP 4.1.0. To avoid encountering this problem with your app, we suggest you update to this version.

[4.1.2] - 2021-11-15

Fixed

  • Various internal obsolete warnings have been removed, allowing the project to be compiled with errors as warnings enabled.

[4.1.1] - 2021-10-28

Changed

  • A default store will be selected for each platform. For Android the default store will be Google. All other platforms already had default stores.

[4.1.0] - 2021-09-20

Added

  • Apple - Add support for receipt validation with StoreKit Test. See the Receipt Validation Obfuscator manual for a usage recommendation. See also the sample "05 Local Receipt Validation" for an example.
  • GooglePlay - Add support for controlling automatic fetching of purchases at initialization, with IGooglePlayConfiguration.SetFetchPurchasesAtInitialize(bool). Use to help distinguish previously seen purchases from new purchases. Then to fetch previously seen purchases use IGooglePlayExtensions.RestorePurchases(Action<bool>).

Changed

  • Menu items for this package were renamed from Unity IAP -> In-App Purchasing and have been moved from Window > Unity IAP to Services > In-App Purchasing.
  • Choosing an Android app store target before building the Android Build Target is now required. A build error will be emitted otherwise. Set this with the Store Selector window (Services > In-App Purchasing > Switch Store ...) or the API (UnityPurchasingEditor.TargetAndroidStore()). The default Android app store is now AppStore.NotSpecified and is visible in the window as <Select a targeted store>. Previously the default app store was the Google Play Store for the Android Build Target. See the Store Selector documentation for more
  • Apple - Workaround rare crash seen if nil NSLocaleCurrencyCode is received when extracting localized currency code from [SKProduct priceLocale] when fetching products. Substitutes ISO Unknown Currency code "XXX" into ProductMetadata.isoCurrencyCode.
  • Removed warning log Already recorded transaction.
  • Codeless - The default setting for enabling Codeless Auto Initialization in new projects' catalogs is now true instead of false. (As seen in the Catalog Editor as "Automatically initialize UnityPurchasing (recommended)").

Fixed

  • Fixed warning, missing await for async call in ExponentialRetryPolicy.cs

Removed

  • Removed the original and complex Unity IAP sample known as "Example", or "IAP Demo". Please use the recently added samples for a granular introduction to In-App Purchasing features.

[4.0.3] - 2021-08-18

Added

  • Added samples to the Package Manager Details view:
    • Apple Sample - Restoring Transactions
    • Apple Sample - Handling Deferred Purchases
    • Apple Sample - Detecting Fraud
    • Apple Sample - Getting Introductory Prices
    • Apple Sample - Present Code Redemption Sheet
    • Apple Sample - Can Make Payments
    • Apple Sample - Retrieving Product Receipts
    • Apple Sample - Subscription Upgrade Downgrade
    • Apple Sample - Promoting Products
  • Apple - Added support for fetching the current store promotion order of products on this device with void IAppleExtensions.FetchStorePromotionOrder(Action<List<Product>> successCallback, Action errorCallback)
  • Apple - Added support for fetching the current store promotion visibility of a product on this device with void FetchStorePromotionVisibilitySuccess(Product product, AppleStorePromotionVisibility visibility)

Fixed

  • Apple - Fixed issue with unknown products being processed with NonConsumable type.

Fixed

  • GooglePlay - Fixed issue that led to purchases failing with a ProductUnavailable error when fetching additional products multiple times in quick succession.
  • GooglePlay - Fixed issue that led to purchases failing with a ProductUnavailable error when a game had been running for some time.
  • GooglePlay - Fixed issue that led to initialization failing with a NoProductsAvailable error when the network is interrupted while initializing, requiring the user to restart the app. Now Unity IAP handle initialization with poor network connectivity by retrying periodically. This retry behavior is consistent with our Apple App Store's, and with the previous version of our Google Play Store's implementations.

Changed

[4.0.0] - 2021-07-19

Added

  • Codeless Listener method to access the store configuration after initialization.
    • CodelessIAPStoreListener.Instance.GetStoreConfiguration
  • Several samples to the Package Manager Details view for com.unity.purchasing:
    • Fetching additional products
    • Integrating self-provided backend receipt validation
    • Local receipt validation
    • Google Play Store - Upgrade and downgrade subscriptions
    • Google Play Store - Restoring Transactions
    • Google Play Store - Confirming subscription price change
    • Google Play Store - Handling Deferred Purchases
    • Google Play Store - Fraud detection
    • Apple App Store - Refreshing app receipts
  • Google Play - GooglePlayProrationMode enum that represent Google's proration modes and added IGooglePlayStoreExtensions.UpgradeDowngradeSubscription using the enum.

Fixed

  • GooglePlay - Fixed Application Not Responding (ANR) error at Product initialization. The Google Play SkuDetailsResponseListener.onSkuDetailsResponse callback is now quickly handled.
  • Amazon - Fixed Product.metadata.localizedPrice incorrectly being 0.00 for certain price formats.
  • Apple, Mac App Store - Fixes Apple Silicon "arm64" support, missing from unitypurchasing bundle.

Changed

  • Reorganized and renamed APIs:
    • CodelessIAPStoreListener.Instance.ExtensionProvider.GetExtension to CodelessIAPStoreListener.Instance.GetStoreExtensions to match the new GetStoreConfiguration API, above
    • IGooglePlayStoreExtensions.NotifyDeferredProrationUpgradeDowngradeSubscription to IGooglePlayConfiguration.NotifyDeferredProrationUpgradeDowngradeSubscription
    • IGooglePlayStoreExtensions.NotifyDeferredPurchase to IGooglePlayConfiguration.NotifyDeferredPurchase
    • IGooglePlayStoreExtensions.SetDeferredProrationUpgradeDowngradeSubscriptionListener to IGooglePlayConfiguration.SetDeferredProrationUpgradeDowngradeSubscriptionListener
    • IGooglePlayStoreExtensions.SetDeferredPurchaseListener to IGooglePlayConfiguration.SetDeferredPurchaseListener
    • IGooglePlayStoreExtensions.SetObfuscatedAccountId to IGooglePlayConfiguration.SetObfuscatedAccountId
    • IGooglePlayStoreExtensions.SetObfuscatedProfileId to IGooglePlayConfiguration.SetObfuscatedProfileId
  • Apple - Change the order of execution of the post-process build script, which adds the StoreKitFramework such that other post-process build scripts can run after it.
  • Changed the Target Android Menu app store selection feature to display a window under Window > Unity IAP > Switch Store.... To set the app store for the next build, first use Build Settings to activate the Android build target.
  • For the future Unity 2022
    • Moved Unity IAP menu items from Window > Unity IAP > ... to Services > In-App Purchasing > ...
    • Updated and added new functionnality to the Services > In-App Purchasing window in the Project Settings. The Current Targeted Store selector and Receipt Obfuscator settings are now accessible from this window.

Removed

  • Samsung Galaxy - Removed Samsung Galaxy Store in-app purchasing support. Use the Unity Distribution Portal for the continued support of the Samsung Galaxy Store.
    • All related classes and implementations have been removed including AppStore.SamsungApps.
  • Removed the following obsolete API:
    • CloudCatalogImpl
    • CloudCatalogUploader
    • CloudJSONProductCatalogExporter
    • EventDestType
    • All GooglePlayReceipt constructors. Use GooglePlayReceipt(string productID, string orderID, string packageName, string purchaseToken, DateTime purchaseTime, GooglePurchaseState purchaseState) instead.
    • IAndroidStoreSelection.androidStore
    • IDs.useCloudCatalog
    • IGooglePlayConfiguration.SetPublicKey
    • IGooglePlayConfiguration.UsePurchaseTokenForTransactionId
    • IGooglePlayConfiguration.aggressivelyRecoverLostPurchases
    • IGooglePlayStoreExtensionsMethod.FinishAdditionalTransaction
    • IGooglePlayStoreExtensionsMethod.GetProductJSONDictionary
    • IGooglePlayStoreExtensionsMethod.IsOwned
    • IGooglePlayStoreExtensionsMethod.SetLogLevel
    • IManagedStoreConfig
    • IManagedStoreExtensions
    • IStoreCallback.OnPurchasesRetrieved. Use IStoreCallback.OnAllPurchasesRetrieved instead.
    • Promo
    • StandardPurchasingModule.Instance(AndroidStore). Use StandardPurchasingModule.Instance(AppStore) instead.
    • StandardPurchasingModule.androidStore. Use StandardPurchasingModule.appStore instead.
    • StandardPurchasingModule.useMockBillingSystem. Use IMicrosoftConfiguration instead.
    • StoreTestMode
    • UnityPurchasingEditor.TargetAndroidStore(AndroidStore). Use TargetAndroidStore(AppStore) instead.
    • WinRT class. Use WindowsStore instead.
    • WindowsPhone8 class. Use WindowsStore instead.

[3.2.3] - 2021-07-08

Fixed

  • GooglePlay - Fix DuplicateTransaction errors seen during purchase, after a purchase had previously been Acknowledged with Google.
  • GooglePlay - Fix DuplicateTransaction errors seen after a user starts a purchase on a game with Unity IAP 1.x or 2.x, quits their game, upgrades their game to include a version of Unity IAP 3.x, and tries to finish consuming / completing that old purchase.

[3.2.2] - 2021-06-02

Added

Fixed

  • WebGL - While WebGL is not supported with an included app store implementation, the WebGL Player will no longer crash when the StandardPurchasingModule.Initialize API is called if Project Settings > Player > WebGL > Publishing Settings > Enable Exceptions > "Explicitly Thrown Exceptions Only" or "None" are set.
  • Amazon - Better support for Android R8 compiler. Added minification (Project Settings > Player > Publishing Settings > Minify) "keep" ProGuard rules.

[3.2.1] - 2021-05-18

Changed

  • Manual and API documentation updated.

[3.2.0] - 2021-05-17

Added

  • GooglePlay - Automatic resumption of initialization when a user's device initially does not have a Google account, and they correct that Android setting without killing the app, then they resume the app. NOTE this does not impact Unity IAP's behavior when a user removes their Google account after initialization.
  • GooglePlay - API IGooglePlayConfiguration.SetServiceDisconnectAtInitializeListener(Action) called when Unity IAP fails to connect to the underlying Google Play Billing service. The Action may be called multiple times after UnityPurchasing.Initialize if a user does not have a Google account added to their Android device. Initialization of Unity IAP will remain paused until this is corrected. Inform the user they must add a Google account in order to be able to purchase. See documentation "Store Guides" > "Google Play" for a sample usage.
  • GooglePlay - It is now possible to check if a purchased product is pending or not by calling IsPurchasedProductDeferred() from GooglePlayStoreExtensions.
  • UDP - RegisterPurchaseDeferredListener in IUDPExtensions can be used to assign a callback for pending purchases.

Fixed

  • GooglePlay - Receipts for Pending purchases are now UnifiedReceipts and not raw Google receipts. Any parsers you have for these can extract the raw receipt json by parsing the "Payload" field.
  • Editor - The Fake Store UI used in Play Mode in the Editor, as well as some unsupported platforms has been restored. A null reference exception when trying to make a purchase no longer occurs.
  • UDP - Added a null check when comparing Store-Specific IDs

Changed:

  • Samsung Galaxy - Support is being deprecated when not using Unity Distribution Portal as a target. The feature will be removed soon. Please use the Unity Distribution Portal package with IAP for full Samsung Galaxy support.

[3.1.0] - 2021-04-15

Added

  • GooglePlay - Google Play Billing Library version 3.0.3.
    • Fixes a broken purchase flow when user resumed their app through the Android Launcher after interrupting an ongoing purchase. Now IStoreListener.OnPurchaseFailed(PurchaseFailureDescription.reason: PurchaseFailureReason.UserCancelled) is called on resumption. E.g. first the user initiates a purchase, then sees the Google purchasing dialog, and sends their app to the background via the device's Home key. They tap the app's icon in the Launcher, see no dialog, and, finally, the app will now receive this callback.

Changed

  • string StandardPurchasingModule.k_PackageVersion is obsolete and will incorrectly report "3.0.1". Please use the new string StandardPurchasingModule.Version to read the correct current version of this package.
  • Reduced logging, and corrected the severity of several logs.

Fixed

  • tvOS - build errors due to undesirable call to [[SKPaymentQueue defaultQueue] presentCodeRedemptionSheet] which will now only be used for iOS 14.
  • tvOS, macOS - Builds missing Xcode project In-App Purchasing capability and StoreKit.framework.
  • Security - Tangle files causing compilation errors on platforms not supported by Security: non-GooglePlay and non-Apple.
  • GooglePlay - Subscription upgrade/downgrade using proration mode DEFERRED (via IGooglePlayStoreExtensions.UpgradeDowngradeSubscription(string oldSku, string newSku, int desiredProrationMode)) reported OnPurchaseFailed with PurchaseFailureReason.Unknown, when the deferred subscription upgrade/downgrade succeeded. This subscription change generates no immediate transaction and no receipt. Now a custom Action<Product> can be called when the change succeeds, and is set by the new SetDeferredProrationUpgradeDowngradeSubscriptionListener API:
    • Adds IGooglePlayStoreExtensions.SetDeferredProrationUpgradeDowngradeSubscriptionListener(Action<Product> action). Sets listener for deferred subscription change events. Deferred subscription changes only take effect at the renewal cycle and no transaction is done immediately, therefore there is no receipt nor token. The Action<Product> is the deferred subscription change event. No payout is granted here. Instead, notify the user that the subscription change will take effect at the next renewal cycle.

[3.0.2] - 2021-03-30

Added

  • Comprehensive manual and API documentation.

[3.0.1] - 2021-03-08

Removed

  • Pre-release disclaimer.

[3.0.0] - 2021-03-05

[3.0.0-pre.7] - 2021-03-03

Added

  • GooglePlay - populate Product.receipt for Action<Product> parameter returned by IGooglePlayStoreExtensions.SetDeferredPurchaseListener callback

Changed

  • WinRT - This feature is now shipped as C# code under assembly definitions instead of .dll files.
  • Security - This feature is now shipped as C# code under assembly definitions instead of .dll files.
  • Receipt Validation Obfuscator - The Tangle File Obfuscate function is now Editor-only and no longer part of the Runtime Security module.

Fixed

  • Windows Standalone - launches FakeStore when detected by StandardPurchasingModule; disentangled from WinRT
  • Security - restored Receipt Validation Obfuscator Editor functionality
  • GooglePlay - fix regression, avoiding exception when using IGooglePlayConfiguration while running on a non-Google target

[3.0.0-pre.6] - 2021-02-09

Fixed

  • WinRT - There was a bad path being pointed to by the .dll's meta file, preventing compilation to this target.

[3.0.0-pre.5] - 2021-01-12

Added

  • Apple - Support for auto-renewable subscription Offer Codes on iOS and iPadOS 14 and later via IAppleExtensions.PresentOfferRedemptionSheet(). E.g.

    public void ShowSubscriptionOfferRedemption(IExtensionProvider extensions)
{
  var appleExtensions = extensions.GetExtension<IAppleExtensions>();
  appleExtensions.PresentOfferRedemptionSheet();
}

Fixed

  • Security and WinRT stub dlls and references to Analytics no longer break builds unsupported platforms like PS4, XboxOne, Switch and Lumin. These platforms are still unsupported but will no longer raise errors on build.

Removed

  • Support for Facebook in-app purchasing is no longer provided. All classes and implementations have been removed.

[3.0.0-pre.4] - 2020-10-09

  • Fix builds for UWP

[3.0.0-pre.3] - 2020-10-09

  • First integration into Unity 2021
  • Includes changes listed in CHANGELOG-ASSETSTORE.md, starting from version 1, ending 2020-10-09
  • This is the first release of the Unified Unity In App Purchasing, combining the old package and its Asset Store Components.

[2.2.2] - 2021-01-19

  • Fixed logs incorrectly formatted showing “purchases({0}): -id of product-”
  • Renamed method IStoreCallback.OnPurchasesRetrieved to IStoreCallback.OnAllPurchasesRetrieved, deprecated old method name. This is to fix a problem when refreshing receipts.

[2.2.1] - 2020-11-19

  • Fixed exposure of function calls at runtime used by the Asset Store Package 2.2.0 and up.

[2.2.0] - 2020-10-22

  • Google Billing v3

[2.1.2] - 2020-09-20

Fix migration tooling's obfuscator file destination path to target Scripts instead of Resources

[2.1.1] - 2020-08-25

  • Fix compilation compatibility with platforms that don't use Unity Analytics (ex: PS4)
  • Fix compilation compatibility with "Scripting Runtime Version" option set to ".Net 3.5 Equivalent (Deprecated)" in Unity 2018.4

[2.1.0] - 2020-06-29

  • Source Code provided instead of precompiled dlls.
  • Live vs Stub DLLs are now using asmdef files to differentiate their targeting via the Editor
  • Fixed errors regarding failing to find assemblies when toggling In-App Purchasing in the Service Window or Purchasing Service Settings
  • Fixed failure to find UI assemblies when updating the Editor version.
  • Added menu to support eventual migration to In-App Purchasing version 3.

[2.0.6] - 2019-02-18

  • Remove embedded prebuilt assemblies.

[2.0.5] - 2019-02-08

  • Fixed Unsupported platform error

[2.0.4] - 2019-01-20

  • Added editor and playmode testing.

[2.0.3] - 2018-06-14

  • Fixed issue related to 2.0.2 that caused new projects to not compile in the editor.
  • Engine dll is enabled for editor by default.
  • Removed meta data that disabled engine dll for windows store.

[2.0.2] - 2018-06-12

  • Fixed issue where TypeLoadException occured while using "UnityEngine.Purchasing" because SimpleJson was not found. fogbugzId: 1035663.

[2.0.1] - 2018-02-14

  • Fixed issue where importing the asset store package would fail due to importer settings.

[2.0.0] - 2018-02-07

  • Fixed issue with IAP_PURCHASING flag not set on project load.