Documentation

​
​

Development

User Acquisition

Monetization

Industry

In-App Purchasing

IAP Client API

IAP SDK API

Webshop Admin API

Webshop Client API

In-App Purchasing

LiveOps
​
​
Get started
  • Overview
  • Introduction to IAP
  • What's new in IAP v5.4
  • Upgrade from IAP v4 to v5
  • AI skill for In-App Purchasing
Direct to Consumer (D2C) payments
  • Direct to Consumer (D2C) payment providers
Webshop
  • Overview
  • Get started with webshops
  • Webshop setup
  • Catalog and payments
  • Game integration for webshops
  • Troubleshooting webshops
Platform-native stores
  • Set up IAP for platform-native stores
  • Codeless IAP
Catalogs and store management
  • Create product catalogs
  • Supported stores
    • Google Play Store
    • Apple App Store
    • Stripe
    • Coda
    • Custom stores
    • Cross-store installation issues with Android in-app purchase store
Purchases
  • Purchase management and fulfillment
Monitor IAP performance
  • Overview
  • IAP revenue performance
  • D2C performance
Privacy
  • Privacy and consent
  1. Unity In-App Purchasing

Android cross-store installation issues

Understand and resolve purchase history loss and synchronization problems when deploying to multiple Android app stores.
Read time 2 minutes
Last updated 9 months ago

There are cross-store installation issues when using shared Android bundle identifiers to publish to multiple Android in-app purchase stores (such as the Google Play Store) 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, if
com.foo.bar
is published on both Google Play and another manufacturer’s app store, a user with both stores installed could install the app from one store and later update it from the other. This can result in the loss of IAP purchase history and prevent the user from restoring previously purchased digital products.

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 or reinstallation and lose any in-flight purchases interrupted by a cross-store upgrade.
The resulting IAP problems are as follows:

Problem type

Description

Losing incomplete purchasesOccurs 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 AOccurs if a user reinstalls an application from store B after completing IAP transactions on store A. They are not 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 listsOccurs 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.

Resolve 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.
  • Use unique bundle identifiers for each store. This may result in duplicate installed apps for the user.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour 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.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Impact of cross-store installation issues

    • Resolve cross-store installation issues


Report a problem with this page