Restore purchases

Enable players to regain access to previously owned products and subscriptions when they reinstall your app or switch devices.

Read time 2 minutes

Last updated 2 months ago

The Restore purchases feature allows players to access previously owned non-consumable products and active, renewable subscriptions without paying again. App stores maintain a permanent record of these entitlements, and Unity IAP can retrieve them to grant access.

Non-renewable subscriptions on Apple platforms can't be restored. If you use non-renewable subscriptions on Apple, you must maintain your own subscription records and synchronize entitlements across devices.

Google Play

After reinstall, Unity IAP restores owned products on the first
```
StoreController.FetchPurchases()
```
call.
IAP invokes the
```
OnPurchasesFetched
```
listener with an
```
Orders
```
object that includes all purchases (all states).
If the
```
PurchaseService.ProcessPendingOrdersOnPurchasesFetched
```
setting is set to true, IAP invokes the
```
OnPurchasePending
```
listener for each unfulfilled purchase.
Subsequent
```
FetchPurchases()
```
calls in the same session don't trigger
```
OnPurchasePending
```
for orders that are already seen by the developer in the same session.

Note

On Google Play,

FetchPurchases()

can only restore a purchase if Unity IAP can match it to product metadata (

ProductDetails

) fetched from the network. If the device is offline and Google Play's local product cache has expired, owned purchases that can't be matched are omitted from the

OnPurchasesFetched

result. This isn't surfaced as an event or exception in your game code, only a console warning:


Unable to process purchase with order id: {orderId} and purchase token: {purchaseToken} because the product details associated with the purchased products were not found.

Don't treat an empty or partial

OnPurchasesFetched

result as confirmation that the player has no entitlements. Check for this warning, and also check

OnProductsFetchFailed

: a product that fetched successfully in the past but fails to fetch now causes the same mismatch. Use

OnStoreDisconnected

to rule out a network/connectivity failure. This is a known limitation as of IAP 5.4.1 and matters most for entitlements you must not incorrectly revoke, such as Google Play Pass access.

Apple platforms

You must provide a Restore Purchases button (mandatory by Apple).
The button calls
```
PurchaseService.RestoreTransactions
```
which requests a transaction resync from Apple to resync transactions and may prompt the user to authenticate.
After resync, Unity IAP calls
```
FetchPurchases
```
and invokes
```
OnPurchasesFetched
```
with all transactions for the user.