Documentation

Support

In-App Purchasing

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 minutesLast updated 10 hours 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.