image/svg+xml
docs.unity3d.com
  • Manual
  • Scripting API
  • Changelog
  • License
In App Purchasing 3.0.2
    Show / Hide Table of Contents
    • Unity IAP
    • Setting up Unity IAP
      • Configuring for Apple App Store and Mac App Store
      • Configuring for Google Play Store
      • Configuring for Windows Store
      • Configuration for the Amazon Appstore
      • Samsung Galaxy IAP configuration
    • Cross Platform Guide
      • Codeless IAP
      • Defining products
      • Subscription Product support
      • Initialization
      • Browsing Product Metadata
      • Initiating Purchases
      • Processing Purchases
      • Handling purchase failures
      • Restoring Transactions
      • Purchase Receipts
      • Receipt validation
      • Store Extensions
      • Cross-store installation issues with Android in-app purchase stores
    • Store Guides
      • i​OS & Mac App Stores
      • Universal Windows Platform
      • Google Play
      • Amazon Appstore and Amazon Underground Store
      • Samsung Galaxy apps
    • Implementing a Store
      • Initialization
      • Retrieving products
      • Handling purchases
      • Store Modules
        • Registering your store
        • Store Configuration
        • Store Extensions
    • Manual
    • Cross Platform Guide
    • Cross-store installation issues with Android in-app purchase stores

    Cross-store installation issues with Android in-app purchase stores

    There are cross-store installation issues when using shared Android bundle identifiers to publish to multiple Android in-app purchase stores (such as Samsung and Google) simultaneously. This page describes the results of these conflicts, and how to resolve the issue.

    The cross-store install scenario is one where a user installs an application from one store (store A), and then upgrades the installation with an application from another store (store B). The opportunity to upgrade a user's installation belongs to the store hosting the newest application version. This scenario can arise when both builds of the application use the same Android bundle identifier and signing key.

    For example, com.foo.bar is published to Google Play and Amazon Appstore. A user who has both App stores installed could install com.foo.bar from Amazon Apps and receive an updated version from Google Play. This could result in them losing IAP digital product transactions, and being unable to restore previously made transactions.

    Impact of cross-store installation issues

    Cross-store conflict can cause intractable end-user problems with applications using IAP. Users may find they lose purchases upon uninstallation/reinstallation and lose any in-flight purchases interrupted by a cross-store upgrade.

    The resulting IAP problems are:

    • Losing incomplete purchases. This occurs if the user upgrades after a purchase has been approved but before the application has acknowledged receiving the purchase from the store's billing system. This can arise when an application fails to synchronize with a cloud inventory service in a timely fashion, or the app crashes before saving this new IAP to the local inventory database.

    • Withholding purchases from store A. This occurs if a user reinstalls an application from store B after completing IAP transactions on store A. They will not be able to restore those transactions. Many stores explicitly disallow applications from accessing other stores' IAP systems. To workaround this utilize a cloud inventory system along with its dependent user identity service.

    • Divergent IAP product lists. This occurs if the upgraded product list in store B's application diverges from the list in store A's version. You may provide divergent IAP cataloges. This may result in an application error when an inconsistent local inventory is read by the store B version, or the user may lose the inventory they previously purchased which is unavailable through the store B version.

    Resolving cross-store installation issues

    There are two ways to resolve cross-store conflicts:

    • use unique signing keys for each store (This results in upgrade error messages from the conflicting store), or
    • use unique bundle identifiers for each store (This may result in duplicate installed apps for the user).
    In This Article
    • Impact of cross-store installation issues
    • Resolving cross-store installation issues
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023