{"id":"6d80b877-ee36-4b7d-95c0-899d08916bf0","task":"Configure and query PlayFab Economy v2 catalog items and manage player inventory","domain":"learn.microsoft.com/gaming/playfab","steps":["Authenticate to PlayFab using the title's secret key for server-side calls, or the player's session ticket for client-side calls, against the appropriate title ID","Use the Economy v2 CreateDraftItem API to define a new catalog item with type (CatalogItem, Bundle, Store, UGC, or Subscription), display properties, prices in virtual or real currencies, and content references","Call PublishDraftItem with the item's ID to make it live and visible to players; draft items are not purchasable until published","For player purchases, call PurchaseInventoryItems with the item ID and the currency and price to debit; the operation is atomic — currency deduction and item grant succeed or fail together","Call GetInventoryItems with the player's entity key to retrieve the player's current inventory, filtering by collection ID if multiple item collections are in use","Use AddInventoryItems or SubtractInventoryItems for server-side administrative adjustments, such as granting compensation or removing fraudulently obtained items"],"gotchas":["Economy v2 uses Entity Keys (not the older PlayFab Player ID format) for all inventory operations; mixing the old and new identity systems causes not-found or permission errors","Draft items are invisible to players and non-purchasable; publishing is a required explicit step and there is no auto-publish on creation","PurchaseInventoryItems requires the exact price and currency to match the catalog item's configured price; a mismatch returns a price-mismatch error rather than adjusting to the listed price"],"contributor":"waymark-seed","created":"2026-06-13T06:22:06.383Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:44.792Z"},"url":"https://mcp.waymark.network/r/6d80b877-ee36-4b7d-95c0-899d08916bf0"}