question

Julius Hipolito avatar image
Julius Hipolito asked

Best Practice for PS4/XB1 Entitlement Setup for RM Transactions

Hi PlayFab Support —

Would it be possible to provide best practice guide for PS4/XB1 Entitlement Setup? The API documentation for ConsumeXboxEntitlements, and ConsumePSNEntitlements, do not describe how the entitlement links to a PlayFab Catalog ItemID when it is consumed.

Given the entitlement ID "TestTitle.GoldPackage" for a $4.99 package on PSN, should I have a Bundle in my catalog that has a matching ItemID of "TestTitle.GoldPackage"?

In a similar situation for a consumable XBoxOne Add-On ID created in the Microsoft Partners dashabord. If we wanted to make a matching $4.99 package, entitlements would be different due to the platform, but we would want a duplicate of the "TestTitle.GoldPackage" bundle in our PlayFab catalog with an ItemID that matches the Xbox add-on ID?

Would you suggest PlayStream logging any additional transaction information that is not provided in the ConsumePlatformEntitlements default log?

Best Regards!

10 |1200

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

1 Answer

·
Andy avatar image
Andy answered

The short answer is that I've requested docs be added that better describe this flow.

The longer answer is that those APIs work a lot like the receipt validation APIs. You make the call and then we validate with the platform store what items the user is entitled to. The difference is that you don't pass in a receipt, we just query the user's entitlements. That means, similar to iOS or Android, the item ids in PayFab need to align with what you set in the platform store. If they're different across stores, you need multiple items in PlayFab.

Try out the flow before deciding whether you need additional telemetry. You'll see player_inventory_item_added events, but we don't have a specific event for the ConsumeEntitlements call. If you feel you need more, then I'd definitely recommend adding it via WritePlayerEvent.

3 comments
10 |1200

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Julius Hipolito avatar image Julius Hipolito commented ·

Thanks Andy!

In the PSN and Xbox Live plugin descriptions, there is the following line:

PlayFab retrieves the player's entitlement record from PSN, and syncs it with the Player's inventory. Any new items are granted, and any expired items are revoked.

Can you elaborate on when the entitlement 'sync' occurs? This question is more towards "durable" items/entitlements that may be revoked if the user asks for a refund on something like a Map Pack or Skin.

0 Likes 0 ·
Andy avatar image Andy ♦♦ Julius Hipolito commented ·

The sync occurs when the API call is made. Consumables are granted to inventory and durables are synchronized between the platform store and the player's in-game inventory. If a durable bundle is revoked, all bundled items are also revoked.

1 Like 1 ·
Julius Hipolito avatar image Julius Hipolito Andy ♦♦ commented ·

Fantastic. Thank's Andy!

0 Likes 0 ·

Write an Answer

Hint: Notify or tag a user in this post by typing @username.

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.