Does Unity IAP save pending transaction receipt to the cloud?

LiuChong · Oct 14, 2018

Hello,

Just wondering does Unity IAP save pending transaction receipts to the cloud automatically? to make sure pengding transaction can be processed even after player uninstall and re-install the app? If so, when will the pending transaction receipts be saved？

Thanks,

unityjingyao · Oct 15, 2018

Hi,
Unity IAP sends every transaction receipt to Unity Analytics before calling 'ProcessPurchase'. But it's used to track transactions in Unity Analytics instead of making sure a pending transaction can be processed again.
Unity IAP will save a transaction record locally when you return 'PurchaseProcessingResult.Complete' in 'ProcessPurchase' or call 'm_Controller.ConfirmPendingPurchase'.

LiuChong · Oct 15, 2018

Thanks for your quick reply, what i am wondering is how unity working with the pending transactions. For example, a user has a pending purchase transaction record locally for some reason. If he uninstall and reinstall the game, the pending record should be removed, right? But we noticed that some players still have the pending payment after re-install.

Could you let me know what is the reason? Is it something controlled by Unity IAP or not?

JeffDUnity3D · Oct 15, 2018

Yes, having a pending purchase will indeed fire ProcessPurchase each time the app launches, regardless of reinstall. Is there a reason you are not confirming these transactions? You can use ConfirmPendingPurchase https://docs.unity3d.com/ScriptReference/Purchasing.IStoreController.ConfirmPendingPurchase.html

LiuChong · Oct 16, 2018

But if the pending purchase transaction record is saved locally, how does the game know if there is a pending purchase after uninstall and re-install? after uninstalling, the pending purchase transaction record should be already deleted, right?

JeffDUnity3D · Oct 16, 2018

My understanding is that the store keeps a record of these pending transactions across installs and across devices (for the same user), I will confirm with the IAP team. Why do you have pending transactions? Just checking, it makes sense if you are doing server side receipt validation for example. What specific behavior are you seeing during your testing?

unityjingyao · Oct 17, 2018

For Google Play, Unity IAP will retrieve all of your already-owned products during initialization, including Non-Consumable, Subscription and pending Consumable products.
For App Store, Unity IAP will do the same operation when you restore your products.
Then Unity IAP will call ProcessPurchase if it doesn't find a local record.

LiuChong · Oct 17, 2018

@JeffDUnity3D @unityjingyao Thanks for your quick response. I know Google Play will keep the non-consumable IAP, and it can be restored even after uninstall and reinstall, but are you sure the Google Play and iOS will keep the pending consumable product?

From the store side, a pending consumable product should be already finished. Just not passed our own server side validation for some reason.

LiuChong · Oct 17, 2018

So i am wondering does Unity IAP save this kind of purchase transaction record to some cloud? coz we do have some players still have this pending status even after they uninstall and re-install the game.

LiuChong · Oct 17, 2018

We test on iOS, when there is a pending consumable payment transaction, after uninstall and reinstall the game, it can still be processed by Unity IAP, how can Unity IAP know about it?

unityjingyao · Oct 18, 2018

Yes, I can confirm that Google Play and App Store keep the pending transactions.
For each purchase, you need to call an API to inform the store that a purchase is finished successfully. This action is called 'consume product' on Google Play, or 'finish transaction' on App Store.
Unity IAP doesn't save pending transactions to track the inventory. It only retrieves them from the app stores.

LiuChong · Oct 18, 2018

Got it, thanks Jingyao.

Another question: Since we have a lot of different in-game IAP packages, so we are using one store product ID corresponding to multiple in-game IAP package ID, is there any best practice how to handle the pending transaction in-game IAP package ID? We currently saved it to PlayerPrefs, and send it to server along with the receipt to verify payment, but after uninstall and reinstall, it will be gone.

unityjingyao · Oct 19, 2018

I'm sorry that Unity IAP doesn't handle the inventory, you have to do it on your own.
For pending transactions, app stores will do that for you. I don't think that you need to do any extra work.
Regarding the product ID, PurchaseEventArgs offers two fields to indicate the ID:
PurchaseEventArgs
.purchasedProduct.definition.id and
PurchaseEventArgs
.purchasedProduct.definition.storeSpecificId.
The first one is the unified product ID used in your game, and the second one is the ID you configured on app store side.

LiuChong · Oct 19, 2018

Thanks @unityjingyao

Do you mean the purchasedProduct.definition.id is a customized parameter that we can set by ourselves?

unityjingyao · Oct 19, 2018

Yes, please find the demo script in 'Assets/Plugins/UnityPurchasing/script/IAPDemo.cs'.

Code (CSharp):

// In this case our products have the same identifier across all the App stores,

// except on the Mac App store where product IDs cannot be reused across both Mac and

// iOS stores.

// So on the Mac App store our products have different identifiers,

// and we tell Unity IAP this by using the IDs class.

builder.AddProduct("100.gold.coins", ProductType.Consumable, new IDs

{

{"com.unity3d.unityiap.unityiapdemo.100goldcoins.7", MacAppStore.Name},

{"000000596586", TizenStore.Name},

{"com.ff", MoolahAppStore.Name},

{"100.gold.coins", AmazonApps.Name}

}

);

LiuChong · Oct 19, 2018

Thanks @unityjingyao , but this is not my question. My question is we have one store product ID corresponding to multiple in-game IAP package IDs. For example, we have a "100.gold.coins" Product ID, but actually in the game there are may be 5 different packs reusing this Produce ID. One of them gives play 100 more food, the other one gives player 100 more wood, etc. Am I clear now?

ap-unity · Oct 20, 2018

Since Unity IAP does not handle inventory management, your scenario will be treated as if you only have a single product, which is how the stores will treat it as well.

LiuChong · Oct 20, 2018

@ap-unity We currently saved the in-game specific IAP package ID to PlayerPrefs, and send it to server along with the receipt to verify payment and send correct together, but after uninstall and reinstall, it is no way to know which is the specific in-game IAP package ID. Do you have any suggestions how to implement this scenario?

unityjingyao · Oct 22, 2018

Thanks for the clarification. It's clear now.
You can use 'developerPayload' to do that for Google Play.
If you are using Unity IAP 1.19+, you can refer to the code below.

Code (CSharp):

// When you buy a product, offer a value to the 'payload' parameter.

m_Controller.InitiatePurchase(m_Controller.products.WithID(productID), "aDemoDeveloperPayload");

...

public PurchaseProcessingResult ProcessPurchase(PurchaseEventArgs e)

{

...

string developerPayload = null;

var receiptDict = (Dictionary<string, object>)MiniJson.JsonDecode(e.purchasedProduct.receipt);

if (receiptDict.ContainsKey("Store") && receiptDict.ContainsKey("Payload"))

{

var payload = (string)receiptDict["Payload"];

if ((string)receiptDict["Store"] == GooglePlay.Name && payload != null)

{

var payloadDict = (Dictionary<string, object>)MiniJson.JsonDecode(payload);

if (payloadDict.ContainsKey("json"))

{

var jsonDict = (Dictionary<string, object>)MiniJson.JsonDecode((string)payloadDict["json"]);

if (jsonDict != null && jsonDict.ContainsKey("developerPayload"))

{

var developerPayloadJSON = (string)jsonDict["developerPayload"];

var developerPayloadDict = (Dictionary<string, object>)MiniJson.JsonDecode(developerPayloadJSON);

byte[] bytes = System.Convert.FromBase64String((string)developerPayloadDict["developerPayload"]);

developerPayload = System.Text.Encoding.UTF8.GetString(bytes);

}

}

}

}

// 'aDemoDeveloperPayload' will be outputed.

Debug.Log("developerPayload: " + developerPayload);

...

}

App Store doesn't support this feature. I'm sorry I don't have a suggestion for App Store yet.

LiuChong · Oct 23, 2018

@unityjingyao Thank you very much, do you know if other platforms have this feature, like Amazon, Samsung, Windows, or Facebook payment ?

unityjingyao · Oct 23, 2018

As far as I know, only Google Play has this feature, at least in Unity IAP. Maybe other stores also have a similar feature, but I've never investigated yet.

LiuChong · Oct 23, 2018

Thank you very much

LiuChong · Oct 23, 2018

@unityjingyao another question, do you know if PlayerPrefs will be saved to iCloud on iOS by default?

JeffDUnity3D · Oct 23, 2018

@LiuChong No, PlayerPrefs is only local to the device and is not saved to the cloud.

LiuChong · Oct 24, 2018

I mean the iCloud on iOS, do you think it will be synced to iCould in some situation?

unityjingyao · Oct 24, 2018

Please find more information about PlayerPrefs on this page.
https://docs.unity3d.com/ScriptReference/PlayerPrefs.html
On iOS, PlayerPrefs are stored in /Library/Preferences/[bundle identifier].plist.

JeffDUnity3D · Oct 24, 2018

LiuChong said: ↑

I mean the iCloud on iOS, do you think it will be synced to iCould in some situation?
Click to expand...

No

LiuChong · Oct 25, 2018

@JeffDUnity3D thank you for reply, so you mean this folder /Library/Preferences/[bundle identifier].plist. will not be synced to iCloud? No matter what kind of settings the user did on iCould?

rickypu · Oct 25, 2018

@LiuChong are you solution to the problem on ios？

JeffDUnity3D · Oct 25, 2018

LiuChong said: ↑

@JeffDUnity3D thank you for reply, so you mean this folder /Library/Preferences/[bundle identifier].plist. will not be synced to iCloud? No matter what kind of settings the user did on iCould?
Click to expand...

Correct, this may help https://support.apple.com/en-us/HT204025 If you want to save to the cloud, you'll need your own server. The flow is described here https://docs.unity3d.com/Manual/UnityIAPProcessingPurchases.html

LiuChong · Oct 25, 2018

@rickypu, no we don't have a prefect solution on iOS, just save to PlayerPrefs.
@JeffDUnity3D But why some of our players still get the PlayerPrefs back after they uninstall and reinstalled the game?

JeffDUnity3D · Oct 25, 2018

If they get PlayerPrefs back, it may be a bug which may be fixed in other versions or due to the OS version, hard to say. At any rate, you should not depend on it.

LiuChong · Oct 26, 2018

@JeffDUnity3D So technically, with Unity, all local persistent files will be removed upon uninstalling, right?

JeffDUnity3D · Oct 26, 2018

@LiuChong PlayerPrefs, yes. If you save files to an SD card or similar, then they may persist. We don't have specific recommendations however. Is there a reason you don't want to save purchases to the cloud using your own server? You could use AWS, Azure or Google for a few dollars a month (or even use a free tier!)

LiuChong · Oct 29, 2018

@JeffDUnity3D Yes we are using our own server to save purchases. The reason we use PlayerPrefs is to save our own in-game payment package IDs. So we we know which specific in-game package ID, and we can send to server for verification. I think @unityjingyao knows clearly about my issue.

JeffDUnity3D · Oct 30, 2018

@LiuChong Understood, good luck on your development.

LiuChong · Oct 31, 2018

@JeffDUnity3D @unityjingyao Thank you guys for all of you help and fast response. I really appreciate!

LiuChong · Jul 25, 2021

@JeffDUnity3D @unityjingyao Hello guys, hope you are doing great. Do you know if Apple IAP support developer payout or not? and what will happen if i set a developer payout on iOS with Unity IAP? Thank you

JeffDUnity3D · Jul 26, 2021

LiuChong said: ↑

@JeffDUnity3D @unityjingyao Hello guys, hope you are doing great. Do you know if Apple IAP support developer payout or not? and what will happen if i set a developer payout on iOS with Unity IAP? Thank you
Click to expand...

I believe you mean payload. The developer payload has been deprecated on both iOS and Android as far as I know. Feel free to test it.

Search Unity

Unity ID

Useful Searches

Does Unity IAP save pending transaction receipt to the cloud?

Unity Technologies

Unity Technologies

Unity Technologies

Unity Technologies

Unity Technologies

Unity Technologies

Unity Technologies

Unity Technologies

Unity Technologies