Skip to content

Commit de4bdff

Browse files
committed
Correct documentation for acknowledged purchases on Google Play
1 parent 3edaa9b commit de4bdff

File tree

3 files changed

+5
-6
lines changed

3 files changed

+5
-6
lines changed

docs/ossv1/ecom/entitlements.mdx

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,7 @@ For Steam users, entitlements include both owned DLC and inventory items in the
2424
</TabItem>
2525
<TabItem value="google-play">
2626

27-
:::caution
28-
You can not retrieve entitlements on Google Play.
29-
:::
27+
For Google Play users, previous non-consumable purchases are visible when you [query for receipts](./purchasing.mdx#querying-receipts-on-startup). Previous purchases that have been acknowledged will be in a transaction state of `Restored`.
3028

3129
</TabItem>
3230
</Tabs>

docs/ossv1/ecom/purchasing.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -234,7 +234,8 @@ You _must_ handle deferred purchases on Google Play. Also, you can not know when
234234
The `OnUnexpectedPurchaseReceipt` event fires:
235235

236236
- When a deferred purchase moves to the `Purchased` state.
237-
- When a receipt is consumed or acknowledged via `FinalizePurchase` and removed from the `GetReceipts` array.
237+
- When a receipt is consumed via `FinalizePurchase` and removed from the `GetReceipts` array.
238+
- When a receipt is acknowledged via `FinalizePurchase` and moves to the `Restored` state.
238239

239240
:::note
240241
The `TransactionId` field of a receipt is the `ReceiptId` to use in other functions.
@@ -264,7 +265,7 @@ There is no callback to pass into `FinalizePurchase`. You can know when the purc
264265
</TabItem>
265266
<TabItem value="blueprints">
266267

267-
To consume a purchase, use the "Finalize Purchase" blueprint node.
268+
To acknowledge or consume a purchase, use the "Finalize Purchase" blueprint node. To acknowledge a purchase instead of consuming it, pass `acknowledge` as the Receipt Info.
268269

269270
:::caution
270271
This function is not an asynchronous blueprint node, and it returns immediately even before the purchase has been consumed.

docs/ossv1/ecom/purchasing/consume.bp

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Begin Object Class=/Script/BlueprintGraph.K2Node_CallFunction Name="K2Node_CallF
3636
CustomProperties Pin (PinId=0B43F7024D91B29D94E30B891DE237CE,PinName="self",PinFriendlyName=NSLOCTEXT("K2Node", "Target", "Target"),PinToolTip="Target\nOnline Purchase Subsystem Object Reference",PinType.PinCategory="object",PinType.PinSubCategory="",PinType.PinSubCategoryObject=/Script/CoreUObject.Class'"/Script/OnlineSubsystemBlueprints.OnlinePurchaseSubsystem"',PinType.PinSubCategoryMemberReference=(),PinType.PinValueType=(),PinType.ContainerType=None,PinType.bIsReference=False,PinType.bIsConst=False,PinType.bIsWeakPointer=False,PinType.bIsUObjectWrapper=False,PinType.bSerializeAsSinglePrecisionFloat=False,LinkedTo=(K2Node_GetSubsystem_1 3807EE1844703EF2B5D3FC989B6582D0,),PersistentGuid=00000000000000000000000000000000,bHidden=False,bNotConnectable=False,bDefaultValueIsReadOnly=False,bDefaultValueIsIgnored=False,bAdvancedView=False,bOrphanedPin=False,)
3737
CustomProperties Pin (PinId=6670375F402676F027BDB28AFBDA035A,PinName="UserId",PinToolTip="User Id\nUnique Net Id Structure",PinType.PinCategory="struct",PinType.PinSubCategory="",PinType.PinSubCategoryObject=/Script/CoreUObject.ScriptStruct'"/Script/Engine.UniqueNetIdRepl"',PinType.PinSubCategoryMemberReference=(),PinType.PinValueType=(),PinType.ContainerType=None,PinType.bIsReference=False,PinType.bIsConst=False,PinType.bIsWeakPointer=False,PinType.bIsUObjectWrapper=False,PinType.bSerializeAsSinglePrecisionFloat=False,LinkedTo=(K2Node_CallFunction_1 307C7EE642FE1ADD1AED718258817116,),PersistentGuid=00000000000000000000000000000000,bHidden=False,bNotConnectable=False,bDefaultValueIsReadOnly=False,bDefaultValueIsIgnored=False,bAdvancedView=False,bOrphanedPin=False,)
3838
CustomProperties Pin (PinId=8DCF9F754D4ABA3C9AEBE6949E5E4440,PinName="ReceiptId",PinToolTip="Receipt Id\nString",PinType.PinCategory="string",PinType.PinSubCategory="",PinType.PinSubCategoryObject=None,PinType.PinSubCategoryMemberReference=(),PinType.PinValueType=(),PinType.ContainerType=None,PinType.bIsReference=False,PinType.bIsConst=False,PinType.bIsWeakPointer=False,PinType.bIsUObjectWrapper=False,PinType.bSerializeAsSinglePrecisionFloat=False,LinkedTo=(K2Node_CallFunction_5 B256AB7243A1D28B6AA99AB610D06E4A,),PersistentGuid=00000000000000000000000000000000,bHidden=False,bNotConnectable=False,bDefaultValueIsReadOnly=False,bDefaultValueIsIgnored=False,bAdvancedView=False,bOrphanedPin=False,)
39-
CustomProperties Pin (PinId=B49DBB9647FC2CD1773052B5DA9DBA71,PinName="ReceiptInfo",PinToolTip="Receipt Info\nString",PinType.PinCategory="string",PinType.PinSubCategory="",PinType.PinSubCategoryObject=None,PinType.PinSubCategoryMemberReference=(),PinType.PinValueType=(),PinType.ContainerType=None,PinType.bIsReference=False,PinType.bIsConst=False,PinType.bIsWeakPointer=False,PinType.bIsUObjectWrapper=False,PinType.bSerializeAsSinglePrecisionFloat=False,PersistentGuid=00000000000000000000000000000000,bHidden=False,bNotConnectable=False,bDefaultValueIsReadOnly=False,bDefaultValueIsIgnored=False,bAdvancedView=False,bOrphanedPin=False,)
39+
CustomProperties Pin (PinId=B49DBB9647FC2CD1773052B5DA9DBA71,PinName="ReceiptInfo",DefaultValue="consume",PinToolTip="Receipt Info\nString",PinType.PinCategory="string",PinType.PinSubCategory="",PinType.PinSubCategoryObject=None,PinType.PinSubCategoryMemberReference=(),PinType.PinValueType=(),PinType.ContainerType=None,PinType.bIsReference=False,PinType.bIsConst=False,PinType.bIsWeakPointer=False,PinType.bIsUObjectWrapper=False,PinType.bSerializeAsSinglePrecisionFloat=False,PersistentGuid=00000000000000000000000000000000,bHidden=False,bNotConnectable=False,bDefaultValueIsReadOnly=False,bDefaultValueIsIgnored=False,bAdvancedView=False,bOrphanedPin=False,)
4040
End Object
4141
Begin Object Class=/Script/BlueprintGraph.K2Node_VariableGet Name="K2Node_VariableGet_0"
4242
VariableReference=(MemberName="Receipt",MemberGuid=176FF00842DB5150C410FA875EDCA033,bSelfContext=True)

0 commit comments

Comments
 (0)